From: Patrick May <patrick@...>
Date: 2004-08-29T14:48:35+09:00
Subject: documenting dynamic method with rdoc

Hello,

I have a class with this code:

     # Append output to client
     [ :<<, :puts, :write, :print ].each{ |symbol|
       define_method(symbol) { |*args|
         @cgd.send_headers if (unbuffered?)
         @content.send( symbol, args )
         @output.send( symbol, args )
       }
     }

I can cause rdoc to document these methods with these stubs in the 
source file before the above code:

     # Append output to client
     def << (*args) end
     # Append output to client with line endings
     def puts(*args) end
     # Append output to client
     def write(*args) end
     # Append output to client
     def print(*args) end

Is there another prefered way to document this sort of thing with rdoc?

Cheers,

Patrick