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


On Wednesday, October 1, 2003, at 03:02 PM, Ara.T.Howard wrote:

> [snip]
>
> first of all, this idea is fantastic.  however, i think it would be 
> made
> better if a standard doccumentation format was also agreed upon.  to 
> me, this
> choice is very simple: html is the only doc format that will easily 
> work on
> mac, windows, and *nix.  rdoc is the best of the html doc generators.  
> ergo,
> rdoc wins my vote.  personally, i prefer man pages but...

I think every package should have rdoc documentation (which can be 
generated upon installation or included in the distribution). I also 
think every command line application (at a minimum) should have man 
pages and useful help and usage output. There are tools to generate man 
pages from other document formats (although better and easier to use 
tools would be good). The above applies to packages in at least the 
beta stage.

> [snip]

I agree completely with all the other stuff you said.

Regards,

Mark