From: Dave Thomas <Dave@...>
Date: 2002-01-09T01:00:05+09:00
Subject: Re: RDoc Alpha-6 available

"NAKAMURA, Hiroshi" <nahi@keynauts.com> writes:

> 1. Can 'Parent' be a link to a doc of parent class?

Yes - that's a good idea. I'll work on it.

> 
> 2. I know I should define it in comment using extra syntax for block
>   but interface summary whith block seems to be broken...
>   ex. http://rrr.jin.gr.jp/doc/Application/classes/Log.html#M000001

In the case of your 'add' method - the one you referenced, it seems to
be correct. The 'yield' takes no parameters, and it shows a block as
{||...} .

However, in the case of the next method, debug, RDoc gets it
wrong. Your source is

   add( SEV_DEBUG, yield, program )

and RDoc is naively taking ", program" as parameters to the
yield. I'll need to fix this.

  
> 3. Can tag name such as 'M000001' become it's real name like 'add',
>    'debug' and 'info'?

There was a deep and meaningful reason I didn't do that, but I can't
remember it for the life of me :) Let me think about it.


Dave