Re: RDoc generates a dangling hyperlink with :stopdoc without :startdoc:

From: Dave Thomas <dave@...>
Date: 2004-04-10 16:12:12 UTC
List: ruby-core #2767
On Apr 10, 2004, at 10:15, Tanaka Akira wrote:

> For example, RDoc generates a hyperlink to classes/M.html which is not
> exists as follows.
>
> % cat a.rb
> module M
>   def m1() end
>
>   # :stopdoc:
>
>   def m2() end
> end


Hmm... Here I'm not sure what to do. I suspect that I really should 
change the definition of :stopdoc: so that it _does_ document the 
module and m1, but not m2. That way there'll be context for m1(). 
However, at the back of my mind I remember that someone asked for the 
current behavior.

Can anyone see any good reason why I shouldn't change RDoc so that 
:stodoc: just applies to elements within a class or module, and not the 
class or module itself?


Cheers

Dave


In This Thread