Re: Making Man Pages

Subject: Re: Making Man Pages
From: Mary Lynn Kostash <mkostash -at- CYGNUS -dot- COM>
Date: Tue, 22 Sep 1998 15:30:58 -0400

Hi Joanne,

I just joined TechWR-L a couple of hours ago so I missed your original
posting. As fate would have it, we are in a similar dilemma. It appears
that I might also have to delve into the mysterious, murky world of man
pages. Like you, I'm not too excited at the prospect.

Would you be able to forward anything of the helpful suggestions you've
received to me? That would be great!


Mary Lynn

Mary Lynn Kostash
Publications Department
Cygnus Solutions - Toronto Office

Email: mkostash -at- cygnus -dot- com

-----Original Message-----
From: Eric J. Ray [SMTP:ejray -at- RAYCOMM -dot- COM]
Sent: Tuesday, September 22, 1998 3:15 PM
Subject: Making Man Pages

Forwarded on request.

Joanne grey wrote:

<<After years of escaping this, it's finally come up. I'm going to have
>write man pages. I've scoured for a book on this, but the
>only books I can find are from 1986 and out of print. Can anyone
>recommend a good primer on writing these beasts? I'm not even sure what
>to write them *in*. TROFF?>>

First I just want to say I'm sorry you are in the position to *have* to
man pages. I would ask why on Earth is this the case, but I guess it

matter --- it just is. Since you mentioned TROFF, I'm assuming this is on

In the late 1980's I single-sourced manuals and online help on UNIX in
NROFF. With some help from our programmers, it worked pretty slick.
Quite efficient. The drawback is that it was real ugly. Your choice of
fonts was one size of non-proportional command line text in normal or bold.

You might find a Hewlett-Packard house and ask if they still have the
*Text Formatters* volume of *HP-UX Concepts and Tutorials*.

I hope you are able to find something.

Betsy Callahan
Technical Documentation Specialist
bbcallah -at- visionael -dot- com

Eric J. Ray RayComm, Inc. ejray -at- raycomm -dot- com

*Award-winning author of several popular computer books
*Syndicated columnist: Rays on Computing
*Technology Department Editor, _Technical Communication_

From ??? -at- ??? Sun Jan 00 00:00:00 0000=

From ??? -at- ??? Sun Jan 00 00:00:00 0000=

Previous by Author: Word vs. FrameMaker
Next by Author: Re: Graphic design use
Previous by Thread: Making Man Pages
Next by Thread: On-line documentation bookshelf

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

Sponsored Ads

Sponsored Ads