Creating man pages!!

I have a question..
How do you create a man page??
marcooAsked:
Who is Participating?
I wear a lot of hats...

"The solutions and answers provided on Experts Exchange have been extremely helpful to me over the last few years. I wear a lot of hats - Developer, Database Administrator, Help Desk, etc., so I know a lot of things but not a lot about one thing. Experts Exchange gives me answers from people who do know a lot about one thing, in a easy to use platform." -Todd S.

jlevieCommented:
Man pages are written in a markup language, troff to be exact. You can write the pages directly with the embedded markup, or write the document in another form and use one of the xxx-to-man converters.

The markup language for troff is documented in the man pages for troff. Actual man pages use a troff macro to simplify the creation of the document and to provide a consistent appearance. The file containing the macros (/usr/lib/groff/tmac/tmac.an) contains comments that will tell you what each of the macros do. It's not that hard to to create a man page once you have a slight familiarity with the markup language and a similar existing man page to go by.

When you type "man troff" on Linux, you are effectively executing "groff -Tascii -man /usr/man/man1/troff.1 | more". Other unix implemetations (SGI for example) have a slightly different method of storing and retrieving man page data.
0

Experts Exchange Solution brought to you by

Your issues matter to us.

Facing a tech roadblock? Get the help and guidance you need from experienced professionals who care. Ask your question anytime, anywhere, with no hassle.

Start your 7-day free trial
It's more than this solution.Get answers and train to solve all your tech problems - anytime, anywhere.Try it for free Edge Out The Competitionfor your dream job with proven skills and certifications.Get started today Stand Outas the employee with proven skills.Start learning today for free Move Your Career Forwardwith certification training in the latest technologies.Start your trial today
Linux OS Dev

From novice to tech pro — start learning today.