From: Gavin Sinclair <gsinclair@...>
Date: 2003-11-28T21:11:06+09:00
Subject: Re: Installing Docs (Was Re: Library directory structure on windows)

On Friday, November 28, 2003, 9:43:47 PM, Hugh wrote:

> On Fri, 28 Nov 2003, Gavin Sinclair wrote:

>> On Friday, November 28, 2003, 2:11:34 AM, Gavri wrote:
>         [...]
>> > why don't installers do that? do ruby application installers never
>> > copy docs to the ruby/docs folder. should i always do it manually?
>> > if so, why?
>         [...]
>> Documentation is not routinely installed as part of a Ruby package
>> installation.  The commonly-used install.rb/setup.rb doesn't do it.  I
>> think I emailed the author about it and he replied that there's no
>> standard place to install the documentation.  I raised an RCR to

> There is also the issue of M17N: which langauge the docs should be
> in, how to support many languages, etc.  I don't really have any
> good answers to that particular (sub)problem.  I suspect Ruby 2's
> emphasis on multinationalization will interact with this problem
> space.

> I have this odd notion that accommodation of many human languages
> fits in with the culture of mutual respect within the ruby
> community, but what might be done to support this I don't know.

Well, you can't translate English language RDoc comments into other
languages, or vice versa.  Some packages are distributed with
multi-lang README and other files.  These would all be copied into the
central documentation area as part of installation.

Gavin