Re: RE How to create UNIX man(ual) pages.

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,
>
>




Previous by Author: Re: QUESTION: Search Engines & WORD Docs.
Next by Author: Re: KeyCaps style Fonts
Previous by Thread: RE How to create UNIX man(ual) pages.
Next by Thread: Re: RE How to create UNIX man(ual) pages.


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


Sponsored Ads