TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: RE How to create UNIX man(ual) pages. From:"Bergerson, Carl A" <Carl -dot- Bergerson -at- UNISYS -dot- COM> Date:Wed, 28 Jan 1998 09:06:02 -0500
> ----------
> From: John Posada[SMTP:posada -at- FAXSAV -dot- COM]
> Sent: Tuesday, January 27, 1998 2:47 PM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: RE How to create UNIX man(ual) pages.
>
> Hey, guys...
>
> You wouldn't believe the amount of help I received when I presented
> this =
> question. Thanks everyone
>
> The replies I received covered everything from how to create simple =
> ASCII files and convert them to UNIX to how to use vi, to how man
> pages =
> are formatted.
>
> I discussed this issue with some of my UNIX guys here in the
> department =
> and this is what I've decided.
>
> First, I was turned on to a book written by AT&T Bell Telephone =
> Laboratories dating back to 1980 called "UNIX Text Editing & =
> Phototypesetting Starter Package".
>
> With this book, which includes a tutorial, I'm on my way to learning
> to =
> "understand" TROFF (sigh).
>
> Next, I have access to the original troff files for the man pages =
> currently on my network.
>
> I'll be picking one of them with a format I'm happy with
>
John, please don't pick one you're happy with. Pick one that is
STANDARD. Man pages have been what they are for more than twenty years.
Please don't try to reinvent this wheel.
> , and hopefully =
> use it as a template where I can change the body text as needed.
>
> Hopefully, this will result in pages that everyone here is happy with.
>
>
> John Posada, Technical Writer (and proud of the title)
> The world's premier Internet fax service company: The FaxSav Global =
> Network
> -work http://www.faxsav.com -personal http://www.tdandw.com
> -work mailto:posada -at- faxsav -dot- com -personal mailto:john -at- tdandw -dot- com
> -work phone: 732-906-2000 X2296 -home phone: 732-291-7811
> My opinions are mine, and neither you nor my company can take credit
> for =
> them.
>
> HEY! Are you coming to the NJ TechWriter lunch? So far, about 10
> of us are. Ask me about it.=20
>
> ~~
> Send commands to listserv -at- listserv -dot- okstate -dot- edu (e.g., SIGNOFF
> TECHWR-L)
> Search archives at:
>http://listserv.okstate.edu/archives/techwr-l.html,
>
>
