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?
Gavin
···
On Saturday, September 27, 2003, 10:46:16 AM, Jim wrote:
On Saturday, 27 September 2003 at 9:35:00 +0900, Gavin Sinclair wrote:
-talk,
What about agreeing on a standard location for installed
documentation?
What about agreeing on a standard location for installed
documentation?
$prefix/doc/foo/
README
api/
etc…
How about
/usr/local/doc/ruby/foo
I don’t know how it got there, but I’ve already got:
$ ls /usr/local/share/doc/ruby
optparse-0.10.1/
If you use the ports system, it’ll create docs and examples directories,
but that’s something the FreeBSD guys are adding in (I know because I
committed about a dozen NetBSD packages and did the same thing).
···
On Saturday, 27 September 2003 at 9:35:00 +0900, Gavin Sinclair wrote:
–
When a Banker jumps out of a window, jump after him – that’s where the
money is.
– Robespierre
Rasputin :: Jack of All Trades - Master of Nuns
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?
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:
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.
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
···
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?