[prev in list] [next in list] [prev in thread] [next in thread] 

List:       ruby-talk
Subject:    [ruby-talk:28799] Re: RDoc - Document Ruby source files
From:       "Jason Voegele" <jason () jvoegele ! com>
Date:       2001-12-17 16:55:02
[Download RAW message or body]

> Robert Feldt <feldt@ce.chalmers.se> writes:
> 
>> Maybe something along the lines of:
>> 
>> ruby -r rdoc program.rb indata1 ... indatan
>> 
>> could solve parts of this problem? Not sure if its a major problem
>> though...
> 
> That would give me the reflection information, but I'd lose the parse
> of the source code, so I'd miss out on the attribute and aliasing
> information, along with the comments.
> 
> This is a tricky one.

Have you considered anything similar to Python's "doc strings", which are 
carried around with methods at run time?  I don't know if they are 
applicable, but could be fodder for some ideas, since I like the idea of an 
object's documentation being part of its run time structure.

Jason


[prev in list] [next in list] [prev in thread] [next in thread]