Francis Hwang wrote:

> A related issue is that if you use method_missing to dispatch method
> calls, there's almost no standard way for a parser to figure out what
> sorts of methods you're intending to define. I run into this a lot
> because my pet project Lafcadio uses method_missing a lot to let
> objects serve as facades for collections of subsystems, and I just
> finished writing RDoc comments for everything. When it came down to
> the methods handled through method_missing, I had to write class
> comments because there's no individual method definition for RDoc to
> parse.

Would it help if I added a facility to RDoc to let you tell it about 
methods that it can't find for itself, perhaps something like:


   # Dynamically constructed method that handles
   # SOAP requests from the washing machine.

   # :def: dynamic_method(arg1, arg2)