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: <p> Paragraph <blockquote> indented block <tt> indented literal text or code <ul> unordered (bullet) list <ol> ordered (numbered) list <li> list item (in a ul/ol) <code> Literal text Also allowed are: <path> Path name <function> Function name <command> Command name <os> Operating System <manpage> Man page cross-reference *** SEE EXAMPLE *** Here's an example: <manpage> <docdate>August 28, 2002</docdate> <doctitle>Document title</doctitle> <os>Darwin</os> <section>1</section> <names> <name>foo<desc>this is a description</desc></name> <name>bar<desc>this is also a description</desc></name> </names> <usage> <flag optional="1">a<arg>attributes</arg><desc>This is the atts flag</desc></flag> <flag>d<arg>date</arg><desc>This is the date flag</desc></flag> <flag>x<desc>This is the -x flag</desc></flag> <arg>filename<desc>This is the filename</desc></arg> </usage> <returnvalues> <p>Returns kIONotANumber if you can't count.</p> <p>Returns kIOMoron if you REALLY can't count.</p> </returnvalues> <environment> TEXT </environment> <files> <file>/path/to/filename<desc>This is a waste of time</desc></file> <file>/path/to/another/filename<desc>This is also a waste of time</desc></file> </files> <examples> TEXT </examples> <diagnostics> TEXT </diagnostics> <errors> TEXT </errors> <seealso> <p>This is a text container, really, but generally contains lines like this:</p> <manpage>foo<section>1</section>, </manpage> <manpage>bar<section>3</section></manpage> </seealso> <conformingto> <p>Here's a list of conformance:</p> <ul> <li>Single UNIX Specification</li> <li>POSIX</li> </ul> </conformingto> <history> This program should be history.... </history> <bugs> <p>Here are some bugs:</p> <p> <ol> <li>Bug one....</li> <li>Bug two....</li> <li>Bug three....</li> </ol> </p> <p>I think that pretty much covers it.</p> </bugs> <topic><name>Some other heading</name> <p>Here is what goes under that heading.</p> </topic> </manpage>