Folks,
It was one of the original goals of this list to see a standard
directory for Ruby-related documentation to be installed. I raised an
RCR recently to that effect. If you haven't seen it already, it's at
http://www.rubygarden.org/article.php?sid=319.
I offered to Matz to work on a more detailed proposal, and he would
like to see one. Now I'm not sure what to put in it :)
As an aside, in my Ruby/Extensions package, in addition to using
install.rb, I also wrote an install-doc.rb. It was meant to be quick
and dirty, but it works great. It installs the following files:
/usr/local/doc/ruby/extensions-0.1.1/
HISTORY
README.html
api/
{rdocs}
The "/usr/local/" is determined by Config::CONFIG['prefix'].
The "doc/ruby/extensions-" is hardcoded.
The "0.1.1" is read from the VERSION file.
This is not perfect, as there is no link in README.html to the RDoc
stuff. But it's a good start.
Anyway, that may get some comments rolling, but back to the main
point. Can you guys make suggestions for the proposal I need to
prepare? I'll leave the floor open...
Cheers,
Gavin
|