[ruby-talk:00764] Re: RD with multi charset

Hi,

  In mail "[ruby-talk:00762] Re: RD with multi charset"
    Clemens Hintze <[e-mail]> wrote:

> > How is this time?
> 
> Sorry for beeing stupid, but I do not understand, what you propose. Do
> you propose the single file scheme, or the multi file one?

Sorry, my discription was too simple.
here's my idea again.


A writer can write his code and document in a single/multi file(s).
And a reader will receive one code file (with English document),
and language specific document files. You can use "rdtool" 
(or other tools) for all these files directy.

My aim is "document swapping". For example, a reader receives
these files:

1:

#!/usr/local/bin/ruby
=begin
= about hello.rb
(doc in English...)
=end
puts 'Hello, World!'

2:

=begin
= hello.rb Ni Tuite
(doc in Japanese)
=end


These files are normal RD files. But if you process these files
by "RD swapper", you will get the file like:

#!/usr/local/bin/ruby
=begin
= hello.rb Ni Tuite
(doc in JAPANESE)
=end
puts 'Hello, World!'


Of course, not only Japanese language can be used.
Only restriction to using this scheme is that all documents
(in some languages) must have same RD structure. In this example,
English document have one =begin...=end and it have one toplevel
block. Japanese document have also one =begin...=end and there's
one toplevel block.

The reason why I present more than one scheme writing document is
mainly for convenience.
matz said he want not to make encoding step for documents.
And I want to write code and all document in one file because it
makes it easy to synchronize code and documents.
So, a writing scheme is not important. The most important point of
my idea is that "all documents have same RD structure".

At last, if you do NOT write documents in my scheme, it is NOT
serious problem. Since all files are normal RD, everyone can read
them. But if my scheme is used, users can read code and ANY document
in a same file.
-------------------------------------------------------------------
Minero Aoki