From: Dave Thomas <Dave@...>
Date: 2002-02-12T09:37:46+09:00
Subject: Help with i18n and RDoc, please....



I'd like to add proper internationalization and multiple language
support to RDoc. My vision is that you'll be able to have a source
program with comments written in (say) Japanese and English, and have
the user be able to select the language that they generate
documentation in. However, as usual, there seems to be more to the
problem than meets the eye. I've had long chat sessions with Jaf,
vruz, and Dorao, but I'm still not sure I get it (in fact I know I
don't get it, particularly when it comes to locales with multiple
encodings). So, in an attempt to get it at least part-way right, I've
put up a wiki page:

    http://www.rubygarden.org/ruby?RDocI18n

I would really appreciate it if folks who understand the issues could
read through this and tell me what works and what doesn't. Remember,
I'm trying to make this as simple and as transparent as possible in
the default case.

Many thanks


Dave