Std-lib require crosslinking sporiadic

I’m assuming this is probably a known issue, but a number of the files
in the std-lib documentation on www.ruby-doc.org don’t properly
crosslink files they require. For instance, drb/observer.rb requires
observer but unlike all of the requires which are local to that library,
and a few random ones that just work, observer is not a link to the
observer std-lib documentation. Anyhow, thought I would point this out,
just in case it had been missed. Another comment, racc shouldn’t be
documented in standard libs, as that is simply the runtime library, the
parser generator is a seperate application. The only docs needed there
are probably a link to the location of the actual generator, and the
documentation there. Thanks,
Charles Comstock

Wrote Charles Comstock cc1@cec.wustl.edu, on Mon, Mar 22, 2004 at 12:19:32PM +0900:

just in case it had been missed. Another comment, racc shouldn’t be
documented in standard libs, as that is simply the runtime library, the
parser generator is a seperate application. The only docs needed there
are probably a link to the location of the actual generator, and the

I think that the tools that come with ruby (the ruby exe itself, ri,
rimport, racc, irb, etc…) should all be documented, and the standard
library docs isn’t a bad place to do so, expecially since many of them
have run-time components (ri is a wrapper around some kind of ri class
in the library, etc.). Also, hopefully sometime there will be a way of
embedding racc grammers in ruby code, so then the racc grammer syntax
will need documentation in the std lib docs…

Cheers,
Sam

···


Sam Roberts sroberts@certicom.com