[ruby-talk:01672] Re: Ruby 1.4 stable manual bug?

The following message is a courtesy copy of an article
that has been posted to comp.lang.misc as well.

Hi,

Muvaw Pnazte <[e-mail]> writes:

|My manual File.html says:
|
|stat(pathname) 
|
|        Splits the pathname in a pair [head, tail], where tail 
|        is the last pathname component and head is everything
|        leading up to that. 
|
|stat(filename) 
|
|        Returns the status info of the filename in the Stat 
|        structure, which has attributes as follows: 

Oops, the former `stat' should be `split'.

|How manuals are made? I think somewhere exists base document (POD?)
|which is then translated into HTML and PDF. Is it possible to get these
|root documents public so that one can make "patches". I would like to
|see the processing program too.

I write them in HTML directly, having plan to move to RD
(Ruby Document format - simplified POD like text).

|I would really like to see current documents to contain (more, better)
|examples and cross-referencing like in this example split and join.
|Producing these might be overkill for one person like Matz but I believe
|in the power of masses (but not chaos :).

Patches, suggestions, document maintainers are always welcome.

							matz.