This is the documentation for the xmlman manpage generation language. The MPGL includes a subset of mdoc. Text is assumed unjustified. The "usage" section becomes the Synopsis and Description sections. Any desc field may contain either a chunk of raw text or it may contain a subset of XHTML:
Paragraph
indented block indented literal text or codeunordered (bullet) list
ordered (numbered) list
- list item (in a ul/ol)
Literal text Also allowed are:
Path name Function name Command name Operating System Man page cross-reference *** SEE EXAMPLE *** Here's an example: August 28, 2002 Document title Darwin 1 foo this is a description bar this is also a description a attributes This is the atts flag d date This is the date flag x This is the -x flag filename This is the filename Returns kIONotANumber if you can't count.
Returns kIOMoron if you REALLY can't count.
TEXT /path/to/filename This is a waste of time /path/to/another/filename This is also a waste of time TEXT TEXT TEXT This is a text container, really, but generally contains lines like this:
foo 1 ,bar 3 Here's a list of conformance:
- Single UNIX Specification
- POSIX
This program should be history.... Here are some bugs:
- Bug one....
- Bug two....
- Bug three....
I think that pretty much covers it.