From: Austin Ziegler <austin@...>
Date: 2003-08-23T15:47:22+09:00
Subject: Re: why not pod?

On Sun, 17 Aug 2003 06:07:29 +0900, Wybo Dekker wrote:
> Is there a good reason why ruby has its own format for embedded
> documentation?
> 
> If only ruby would see:
> 
> =pod as an alias for =begin
> 
> and
> 
> =cut as an alias for =end
> 
> then perldoc, pod2html, pod2latex, pod2text, pod2man, and pod2usage would
> all work with ruby scripts as well as with perl scripts.
> 
> This would also free us from ugly constructs like ((% something %))

I don't even use =begin/=end, preferring RDoc comments. I've always thought 
that POD should be COD (crappy-old...), being a nasty hack.

-austin
--
austin ziegler    * austin@halostatue.ca * Toronto, ON, Canada
software designer * pragmatic programmer * 2003.08.23
                                         * 02.45.31