From: matz@... (Yukihiro Matsumoto)
Date: 2001-08-31T15:02:05+09:00
Subject: [ruby-talk:20603] Re: multi-lingual inline comments using rd...

Hi,

In message "[ruby-talk:20601] Re: multi-lingual inline comments using rd..."
    on 01/08/31, Sean Chittenden <sean-ruby-talk@chittenden.org> writes:
|
|	Let me take another shot at asking this.  In the interest of
|being able to provide multi-lingual documentation, I'm curious as to how
|other developers and people have handled doing multi-lingual
|documentation using RD.  Here are a few ideas that I've had, but want to
|bounce past other people because to see what seems like the most
|plausible.
|
|*) At install time for a software package, does the install script
|perform some magic based on some environment variables?
|
|*) Store the multilingual data in XML and then substitute it inline with
|the module(s) being installed?
|
|*) Create an external directory that w/ two possible structures:
|
|   a)  %%PREFIX%%/doc/foo/bar/baz.rd.en
|   b)  %%PREFIX%%/doc/en/foo/bar/baz.rd
|
|	Where the module being looked up is in the name space
|foo::bar::baz

net/smtp.rb etc. used the last scheme.  They put Japanese document in
doc/net directory.

							matz.