From: Dave Thomas <Dave@...>
Date: 2000-08-08T10:52:37-05:00
Subject: [ruby-talk:04353] Re: DRY and embedded docs.

Toshiro Kuwabara <toshirok@yb3.so-net.ne.jp> writes:

> Hi,
> 
> In message "[ruby-talk:04344] Re: DRY and embedded docs."
>     on 00/08/08, Dave Thomas <Dave@thomases.com> writes:
> >Now, I just had a thought... Wouldn't it be neat if rdtool had an
> >option that did just this, so you could say
> >
> >     RD::usage
> >
> >and it would format up the text neatly for you?
> 
> What does it mean?
> RDtool should do same thing your usage does?(i.e. simply output RD
> in script file to STDOUT?)
> Or, in addition, format it into some kind of format(ex. plain text
> but formatted) and output to STDOUT?

I think the latter would be nice. Perhaps it should look for an entry
such as

  = Usage

and just format that. That way, you could just output the usage
section of a larger RD document.


What do people think?



Dave