From: "ara.t.howard" <ara.t.howard@...>
Date: 2008-08-06T01:57:16+09:00
Subject: Re: perl and the culture of libraries


On Aug 5, 2008, at 8:46 AM, Avdi Grimm wrote:

> I've always liked the Perl documentation conventions.  Particularly
> the fact that *every* CPAN manpage starts with a Synopsis which
> demonstrates the essential usage of the library in a few lines of
> code.

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


Main {

   description "

      stuff about the great program

   "


   def run
     do_stuff
   end


}


because a script that does not declare what it does in the first 10  
lines is evil and a script that does not have '--help' doubly so.

a @ http://codeforpeople.com/
--
we can deny everything, except that we have the possibility of being  
better. simply reflect on that.
h.h. the 14th dalai lama