From: Mark Wilson <mwilson13@...>
Date: 2003-10-02T04:56:36+09:00
Subject: Re: [RCR] Include CONFIG::Config['rubydocdir'] in rbconfig.rb

[snip]

> The documentation dir should probably only handle libraries.

In this case of Ruby, I disagree. Given the transparency of Ruby 
source, there's not that much difference between libraries and many 
applications. Many applications have discrete models that are most 
analogous to libraries also.

> With applications, it shouldn't matter what language they are written 
> in, so
> the documentation should go in the same place as any other program
> documentation. You wouldn't have /usr/share/doc/c/gawk/README or
> something like that.

This begs the question of where application documentation, regardless 
of language, should go. I would like Unix/Linux/BSD etc. to have a more 
accessible standard for this, for command line apps, beyond man and 
info pages. GUI apps can, of course, have their own help menu item. The 
command line help is usually, properly in my opinion, abbreviated. It 
would be nice, however, to at least know where to find Ruby application 
documentation, even if one has to search for documentation (other than 
man pages) for other command line applications.

> [snip]

Regards,

Mark