From: Alexander Bokovoy <a.bokovoy@...>
Date: 2001-12-17T19:29:02+09:00
Subject: [ruby-talk:28748] Re: RDoc - Document Ruby source files

On Sun, Dec 16, 2001 at 11:28:45AM +0900, Dave Thomas wrote:
> I'm sure this code has many holes, so I'd appreciate feedback, bug
> reports, fixes, and so on. I'm also hoping people will be writing
> different backends for it (like the UML diagram generator that was
> discussed a while back). If you want to do that, drop me an e-mail and
> we can discuss the interface.
It would be interesting to see backend that allows RPM to produce correct
Requires: and Provides: tags when building RPMS with Ruby code in it.
This is problem similar documentation one.

However, I would like to see support for dynamically generated classes
like this one:

module Midgard

    # Generate stubs for Midgard<Object> classes, each in its own module
    $MidgardObjects.each do |symbol,table|
	line = __LINE__ + 1
	eval %{
	    module #{symbol}
		class Midgard#{symbol} < MidgardObject
		    def initialize(mgd, value=-1)
			super (mgd, "#{table.to_s.downcase}", value)
		    end
		end
	    end
	}, binding, __FILE__, line
    end

end

Which produces set of nested modules and class definition stubs according 
to content of $MidgardObjects hash. Currently rdoc does not understand
this while this technique is quite useful in Ruby.

Does anybody have ideas how we could improve rdoc for this?

-- 
/ Alexander Bokovoy
$ cat /proc/identity >~/.signature
  `Senior software developer and analyst for SaM-Solutions Ltd.`
---
Nov 21 20:58:58 alconost kernel: VFS: Busy inodes after unmount. 
		    Self-destruct in 5 seconds.  Have a nice day...