From: Eric Hodel <drbrain@...7.net>
Date: 2007-08-11T10:14:05+09:00
Subject: Re: RDoc vs. alias_method

On Aug 10, 2007, at 08:16, Noah Easterly wrote:
> Whoever uses ToothCare can just call #gargle,#rinse,or #spit - they
> don't have to worry about which implementation they're using.
> Meanwhile, I can use #dentist_gargle and #hygenist_gargle to test and
> compare.
>
> This works pretty well, except when I run RDoc.  It's not smart enough
> to figure out that the alias_method creates instance methods named
> #gargle,#rinse, and #spit, and so they don't get documented.
>
> Is there any easy and DRY way I can tell RDoc to document those
> methods?

Nope.  The Ruby parser doesn't understand the document-method stuff  
that the C parser has.

... So writing a patch and submitting it on the RDoc bug tracker is  
the most DRY way to do that.

--
Poor workers blame their tools. Good workers build better tools. The
best workers get their tools to do the work for them. -- Syndicate Wars