From: Dave Thomas <Dave@...>
Date: 2002-09-06T04:12:32+09:00
Subject: Re: Document tools

<bbense+comp.lang.ruby.Sep.05.02@telemark.stanford.edu> writes:

> An rd2 output format would take care of the first two. I think
>   there's a lot of potential in the idea of using rdoc as the
>   document creating tool and something POD-like as the output
>   format. The one problem that I see is that rdoc produces
>   output that is some ways "ruby-smart", it knows methods belong
>   to classes. It would be good if the basic output format 
>   could preserve that knowledge in some way. As far as I know,
>   rd2 is just markup. 

I'm not sure I see the benefit in the intermediate rd2 or POD
step. RDoc already generates XML, so just about any format you need is
just an XSL transform away, and I personally believe that RDoc format
is just as readable as POD. Remember too that RDoc doesn't just work
on Ruby source: you can feed it text files and it's quite happy.


Dave