mjhjmtu

I would like to parse man pages into a more structure form, but I'm unable to find a proper specification for the data format under use by man pages. Should I be looking for troff or nroff or groff or something else? groff(7) says

The groff system has all features of the classical roff, but adds many extensions.

Are these extensions the various preprocessors like tbl or something else?

So far I've found the following resources:

• troff.org - This has historical notes and some tutorials, and some dead links.




• roff(7) (OpenBSD, Linux) - Doesn't really have a specification, only a brief overview and bunch of history.




• man-pages(7) (Linux) - This provides guidelines about sections in man pages (which is useful), but it doesn't talk about the data format.




• A Typesetter-independent TROFF and Troff User's Manual - these are fairly old, so I can't really judge what the differences are between the troff in those papers and in practice.

Is there a clear specification somewhere for the exact format under use by man pages?

Yup. Think like HTML... but pre-HTML. Basically a bunch of typesetting macros for groff ...

First, there are some commonly agreed on sections - of course you can add more...

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
BUGS
AUTHOR
SEE ALSO

And for each (and everywhere else) you use the groff typesetting macro syntax.

For example, a TITLE HEADER can be done like so -

.TH [name of program] [section number] [center footer] [left footer] [center header]

Or a SECTION HEADER -

.SH [section name]

And of course, you can bold, italic, underline, etc -

.B = bold
.BI = bold alternating italic
.BR = bold alternating Roman
.I = italic
.IB = italic alternating bold
.IR = italic alternating Roman
.RB = Roman alternating bold
.RI = Roman alternating italic 

And you can even make comments in your text file -

." This is a comment

And then things like paragraphing (like the <p></p> html tag set) with .PP

Don't forget to name the file appropriately, and then gzip it when done.

This info (and more) is from http://www.linuxhowtos.org/System/creatingman.htm