Re: UNIX manual page development tool

Subject: Re: UNIX manual page development tool
From: Sandy Harris <sandy -at- storm -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 17 Sep 2001 10:13:09 -0400

Max Zimani wrote:

> I've searched the archives for a tool I could use to develop UNIX manual
> pages, to no avail. I know of the prospects of using the VI editor, but hope
> that there's a better way of producing manual pages. So, if have any
> information about this topic, please share it with me.

The DocBook SGML and XLM DTDs were developed largely by Unix companies
(Sun, O'Reilly, ...) and are widely used in the Open Source community.
They include tags for "reference pages" which are essentially Unix man
pages.

Norm Walsh's excellent book "DocBook: the Definitive Guide", published
by O'Reilly has a section on this, starting on p 44.

Book home page:
www.docbook.org

I'm not sure if there are tools that will translate DocBook to the
nroff format used in traditional man pages. If so, there'd likely
be a link to them at the Linux Documentation Project site:
www.linuxdoc.org

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/

+++ Miramo -- Database/XML publishing automation. See us at +++
+++ Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion +++
+++ More info: http://www.axialinfo.com http://www.miramo.com +++

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


References:
UNIX manual page development tool: From: Max Zimani

Previous by Author: Re: Thank you, Eric
Next by Author: Re: How much do people need to be told in documentation.
Previous by Thread: Re: UNIX manual page development tool
Next by Thread: How much do people need to be told in documentation.


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


Sponsored Ads