From: dblack@...
Date: 2002-09-08T02:26:44+09:00
Subject: Re: Document tools

Hi --

On Sun, 8 Sep 2002, Dave Thomas wrote:

> Doesn't seem to be much difference in readability to me. Why would I
> convert RDoc as an input format to POD as an output format. Wouldn't I
> be better off adding the extra output processors that folks wanted?

That last may be intended as a rhetorical question, but I'll go ahead
and answer it anyway:

Yes.

:-)

I'm honestly not sure why the subject of POD has arisen at all in
connection with Ruby.  We have such a nice, integrated, pluggable,
expandable tool in RDoc.  Another quote from perlpod(1): "The intent
is simplicity, not power."  With RDoc, we have both :-)

(I know there are some things to be considered in the rd/RDoc
relationship -- I'm not trying to write rd off by enthusing about RDoc
-- but I don't see the relevance of POD to the process.)


David

-- 
David Alan Black                      | Register for RubyConf 2002!
home: dblack@candle.superlink.net     | November 1-3
work: blackdav@shu.edu                | Seattle, WA, USA
Web:  http://pirate.shu.edu/~blackdav | http://www.rubyconf.com