Re: Mailutils new competitor

[Jeff Bailey]

On Thu, Feb 15, 2001 at 11:29:17AM -0500, Alain Magloire wrote:

> Shaleh wanted to go the same route.  Javadoc and the likes make nice 
> html(sgml)
> reference pages that can seem(at first glance) easy to maintain.
> But IMHO, they don't provide quality documentation in the tutorial sense.
> If someone has the time to change the framework for this, I will
> follow the rule.

I think this route is a good starting place because it means the docs can 
be generated right from the source.  The programmer needs to have enough 
discipline to put the right stuff in comments to provide details, but 
it can be written down easily while you're coding.

> Already exist a pool of those tools(literate progrmming).  Some
> clone javadoc some other have other special markups.

Ahh!  Thanks for the keywords to use.  I was having very poor luck.

David O'tool wrote something: http://dto.qwsi.net/cbk.php3
and apparently GNU Pic is using it.  I'll take a look and see what I 
think of it/

This one produces appears to produce LaTeX output.

> > I can take that on, I think.  If there's no objections, I'll post this 
> > list as the bug list, and suggest that emails go straight to 
> > address@hidden for now.  We should have a web page first, though.  I'll 
> > think about that for a couple of days first, though.
> 
> Yes, think about your experience when you got slashdoted ;-)

<giggle>  At least they won't be attacking my home machine again!

And I get to choose when it's announced, this time. ;)

-- 
Talk is a trick for taking the mystery out of the world.
 - Seeker, Beyond the fall of night.