From: Massimiliano Mirra <list@...>
Date: 2002-09-08T04:37:39+09:00
Subject: Re: Document tools

On Sun, Sep 08, 2002 at 12:21:58AM +0900,
bbense+comp.lang.ruby.Sep.07.02@telemark.stanford.edu wrote:
> - - Well, the only reason that 99% of perl modules have
>   documentation is that the easiest way to get started
>   writing a module is to run a program that sets up the
>   structure for you. One of the things this program does
>   is write a dummy doc skeleton with embarassing comments
>   like
> 
>   "Stub documentation for Foo, created by h2xs. It looks like the
>    author of the extension was negligent enough to leave the stub
>    unedited. "
> 
>    Perhaps we should add this feature to rpkg. 

But I'd get to choose the comments, and you don't want that, believe
me. <veg>


Massimiliano