Re: Single source man pages? (Was: do you write or edit man pages?)

Subject: Re: Single source man pages? (Was: do you write or edit man pages?)
From: Eric Ray <ejray -at- raycomm -dot- com>
To: Peter Kleczka <pkleczka -at- yahoo -dot- com>
Date: Sun, 13 Feb 2000 15:01:00 -0700



> If any of you TechWrl's can point
> me to information about how
> programmers actually go about
> structuring their comments so that
> the comments can be extracted to
> produce the documentation, please
> let me know.

Well, it's not man pages, but Sun's Javadocs are a really good
example of what you're talking about. See
http://java.sun.com/products//jdk/1.3/docs/tooldocs/javadoc/standard-doclet.html

From a pure tech pubs perspective, they're far from perfect. That
said, they're well understood and relied upon by Java programmers
everywhere.

Eric




Previous by Author: ADMIN: Sorry!
Next by Author: ADMIN: Let's can the spam discussion
Previous by Thread: Single source man pages? (Was: do you write or edit man pages?)
Next by Thread: Pyramid Principle book Barbara Minto


What this post helpful? Share it with friends and colleagues:


Sponsored Ads