RDoc/Ruby1.9 problems

I had previously installed RDoc. I checked out the latest Ruby via CVS,
then typed

% ./configure --enable-install-doc
% make
% make install

At the end of the compilation process, I saw

Generating RDoc documentation
/usr/local/bin/ruby ./bin/rdoc --all --ri-system .
./bin/rdoc:59:in `require': No such file to load -- rdoc/rdoc (LoadError)
    from ./bin/rdoc:59
make: *** [install-doc] Error 1

Following a suggestion by Gavin Sinclair on the ruby-doc email list, I
tried un-installing the existing RDoc installation and redoing everything.
That didn’t fix the problem; I still see the same error.

I don’t think that RDoc is getting installed by the CVS version of Ruby,
but it tries to use rdoc.

Any suggestions?

Thanks for your help.

Jim

···


Jim Menard, jimm@io.com, http://www.io.com/~jimm/
"‘Deconstruct and recontextualize’ sounds fancier than ‘cut and paste’,
but it’s the same thing." – Donald Welsh in rec.humor.oracle.d

I don't think that RDoc is getting installed by the CVS version of Ruby,
but it tries to *use* rdoc.

Look if it install rdoc, with

svg% ./ruby -v
ruby 1.9.0 (2004-01-11) [i686-linux]
svg%

svg% make install
[...]
install -c -p -m 0644 lib/rdoc/options.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
install -c -p -m 0644 lib/rdoc/rdoc.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
install -c -p -m 0644 lib/rdoc/template.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
[...]
svg%

Guy Decoux

Jim:

The folks at ruby-doc have nothing to do with ri and rdoc (apart from
using it). Feel free to drop me e-mail and I’ll do my best to help.

In this case, the “–enable-install-doc” option is not current. In the
latest CVS, the installation is enabled by default (there was much
discussion on ruby-code about this. At some point matz decided and the
patch went in) Could you check your Makefile. You should find lines
that look something like:

install: install-nodoc install-doc

install-nodoc: rbconfig.rb
$(MINIRUBY) $(srcdir)/instruby.rb $(SCRIPT_ARGS)
–mantype=“$(MANTYPE)”
$(MINIRUBY) $(srcdir)/ext/extmk.rb $(SCRIPT_ARGS) install

what-where no-install: rbconfig.rb
$(MINIRUBY) $(srcdir)/instruby.rb -n $(SCRIPT_ARGS)
–mantype=“$(MANTYPE)”
$(MINIRUBY) $(srcdir)/ext/extmk.rb -n $(SCRIPT_ARGS) install

install-doc:
@echo Generating RDoc documentation
$(bindir)/$(PROGRAM) $(srcdir)/bin/rdoc --all --ri-system $(srcdir)

Cheers

Dave

···

On Jan 11, 2004, at 8:06, Jim Menard wrote:

Following a suggestion by Gavin Sinclair on the ruby-doc email list, I
tried un-installing the existing RDoc installation and redoing
everything.
That didn’t fix the problem; I still see the same error.

ts decoux@moulon.inra.fr writes:

I don’t think that RDoc is getting installed by the CVS version of Ruby,
but it tries to use rdoc.

Look if it install rdoc, with

svg% ./ruby -v
ruby 1.9.0 (2004-01-11) [i686-linux]

Yup, ruby 1.9.0 is installed

svg%

svg% make install
[…]
install -c -p -m 0644 lib/rdoc/options.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
install -c -p -m 0644 lib/rdoc/rdoc.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
install -c -p -m 0644 lib/rdoc/template.rb /home/ts/local/r190/lib/ruby/1.9/rdoc
[…]

Nope. I see

install -c -p -m 0755 bin/rdoc /usr/local/bin/rdoc

but not the lines you posted.

Jim

···


Jim Menard, jimm@io.com, http://www.io.com/~jimm/
“We’ve heard that a million monkeys at a million keyboards could produce the
Complete Works of Shakespeare; now, thanks to the Internet, we know this is
not true.” – Robert Wilensky, University of California

[courtesy cc of this posting sent to cited author via email]

In article 92E5517B-444D-11D8-B242-000A95676A62@pragprog.com,

The folks at ruby-doc have nothing to do with ri and rdoc (apart from
using it). Feel free to drop me e-mail and I’ll do my best to help.

Trying to run the “rdoc --all -R $PWD” to generate ri data on 1.8.1 leads

to the following:

[…]
bignum.c:
array.c:
Generating RI…
/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/to_flow.rb:92:in
accept_rule': undefined local variable or method size’ for #SM::ToFlow:0x11795720 (NameError)
from/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:170:in
accept' from/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:165:in each’
from/usr/local/lib/ruby/1.8/rdoc/markup/simple_markup/fragments.rb:165:in
accept' from /usr/local/lib/ruby/1.8/rdoc/markup/simple_markup.rb:259:in convert’
from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:224:in
markup' from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:153:in generate_method_info’
from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:133:in
generate_class_info' from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:132:in each’
from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:132:in
generate_class_info' from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:90:in process_class’
from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:85:in
generate' from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:84:in each’
from /usr/local/lib/ruby/1.8/rdoc/generators/ri_generator.rb:84:in
generate' from /usr/local/lib/ruby/1.8/rdoc/rdoc.rb:210:in document’
from /usr/local/bin/rdoc:63

Any idea?

···

Dave Thomas dave@pragprog.com wrote:


Ollivier ROBERT -=- Eurocontrol EEC -=- ollivier.robert@eurocontrol.int
Usenet Canal Historique FreeBSD: The Power to Serve!

Nope. I see

    install -c -p -m 0755 bin/rdoc /usr/local/bin/rdoc

but not the lines you posted.

well, my instruby.rb do

for f in Dir["lib/**/*{.rb,help-message}"]
  dir = File.dirname(f).sub!(/\Alib/, rubylibdir) || rubylibdir
  makedirs dir
  install f, dir, :mode => 0644
end

Guy Decoux

Jim:

Did you run ‘autoconf’?

Cheers

Dave

···

On Jan 11, 2004, at 9:56, Jim Menard wrote:

Nope. I see

install -c -p -m 0755 bin/rdoc /usr/local/bin/rdoc

but not the lines you posted.

Dave Thomas dave@pragprog.com writes:

Nope. I see

install -c -p -m 0755 bin/rdoc /usr/local/bin/rdoc

but not the lines you posted.

Jim:

Did you run ‘autoconf’?

I refreshed CVS, ran

./configure
make
sudo make install

The first think that “make” did was run autoconf.

This time, the Makefile reads

install:        install-nodoc install-doc

However, it still only installs the rdoc binary but does not install the rdoc
ruby library.

I’m on Mac OS X, if that matters. Thanks for your help.

Jim

···

On Jan 11, 2004, at 9:56, Jim Menard wrote:

Jim Menard, jimm@io.com, http://www.io.com/~jimm/

A Ruby script that prints all the digits of pi (sorted).

(0 … 9).each { | i | print i while true }

Me too.

By any chance… when you checked out of CVS, did you forget to use the
‘-d’ option? Do you actually have the RDoc libraries downloaded to your
box? (After you check out, do an ls lib/rdoc)

Cheers

Dave

···

On Jan 11, 2004, at 11:01, Jim Menard wrote:

However, it still only installs the rdoc binary but does not install
the rdoc
ruby library.

I’m on Mac OS X, if that matters. Thanks for your help.

Dave Thomas dave@pragprog.com writes:

By any chance… when you checked out of CVS, did you forget to use the
‘-d’ option? Do you actually have the RDoc libraries downloaded to your
box? (After you check out, do an ls lib/rdoc)

AAARRRGGGHHH! Rather, ARGV! I always forget “-d”. It’s time to retrain my
fingers.

That was it. Thank you, Dave.

Jim

···


Jim Menard, jimm@io.com, http://www.io.com/~jimm/
“If you mark half [of this newsgroup’s] posts as read, you still get
basically all the same information, just with a bit less detail. [This] is
a holographic newsgroup.” – Tom “Tom” Harrington in rec.humor.oracle.d

$ cat >> ~/.cvsrc
cvs update -d
^D

Cheers,
Gavin

···

On Monday, January 12, 2004, 5:46:38 AM, Jim wrote:

Dave Thomas dave@pragprog.com writes:

By any chance… when you checked out of CVS, did you forget to use the
‘-d’ option? Do you actually have the RDoc libraries downloaded to your
box? (After you check out, do an ls lib/rdoc)

AAARRRGGGHHH! Rather, ARGV! I always forget “-d”. It’s time to retrain my
fingers.

That was it. Thank you, Dave.