Gavin Sinclair
9/28/2003 12:42:00 AM
On Sunday, September 28, 2003, 1:57:22 AM, Jim wrote:
> On Saturday, 27 September 2003 at 11:46:28 +0900, Gavin Sinclair wrote:
>> On Saturday, September 27, 2003, 10:46:16 AM, Jim wrote:
>>
>> Currently, I have
>>
>> $ ls /usr/local/doc/ruby/
>> ri-1.8b ruby-1.8.0
>>
>> And Joel mentioned optparse. I know ri uses a home-grown installer,
>> and optparse is now standard library, but I''ll see if I can find out
>> how it might get there.
>>
>> It''s pretty common for documentation directories, in particular, to
>> have version numbers associated. Is that something we would want to
>> expect with ruby packages?
>>
> Yes
OK. Nobody has said that we shouldn''t have such a standard, nor that
such a standard should be in some way different, so I suppose we have
two important steps:
1. Engineer mkconfig.rb so that the following line appears in
rbconfig.rb:
CONFIG["rubydocdir"] = "$(prefix)/doc/ruby"
On my Cygwin build, that will evaluate to /usr/local/doc/ruby.
On my Windows build, that will evaluate to
D:/Software/ruby/doc/ruby.
2. Ask Minero Aoki to make use of this in setup.rb/install.rb:
Given
foo/install.rb
foo/doc/README
foo/VERSION (contains "1.5b")
Then
cd foo
ruby install.rb {config|setup|install}
Produces
/usr/local/doc/ruby/foo-1.5b/README
That idea of a "VERSION" file is something I just thought of, and I''m
sure someone will think of something better.
After some time for comments on this list (read: I''m about to go out
for the rest of the day) I''ll submit an RCR for the first point above.
Regards,
Gavin