From: Dave Thomas <dave@...>
Date: 2008-08-06T04:52:20+09:00
Subject: Re: perl and the culture of libraries


On Aug 5, 2008, at 11:57 AM, ara.t.howard wrote:

> i have to agree with this.  one of the main goals of my main.rb lib  
> was to be able to enable *every* program to have a '--help' option,  
> and to allow writing programs that look like this


RDoc:Usage extracts the comment at the top of your main program as  
your help message (after stripping the '#' characters).

I'm not sure if it is still working, given the changes to RDoc, but as  
a concept I still think it's a nice way to do it: you can read the  
source, or do --help, and get the same information, and all without  
any extra stuff in your source file.


Dave