From: Gavin Kistner <gavin@...>
Date: 2004-02-19T01:02:29+09:00
Subject: Re: Builtins RDoc tarball?

On Feb 18, 2004, at 8:32 AM, Dave Thomas wrote:
> Look in the source file for time.c: can you see comments containing 
> the documentation in front of the C methods that implement the class's 
> public interface? If not, you're probably looking at an old version of 
> the source.

That was the case, where 'old' is 1.8.1, and not a 1.9 snapshot.

Getting 1.9 for rdoc building did the trick. (Or rather, I can see the 
methods of Time now. I'm still fighting to find out what file(s) are 
causing rdoc to crash when writing the output) Thanks :)


While I've got you here...is there a way to get rdoc to document 
multiple call sequences for a method in a .rb file? I tried mimicking 
the style seen in time.c:

/*
  *  call-seq:
  *     Time.at( aTime ) => time
  *     Time.at( seconds [, microseconds] ) => time

But putting that same sort of code in myfile.rb:

#  call-seq:
#     MutableTime.foo( a )
#     MutableTime.foo( b )

...failed to produce the same results.