Originally developed to generate the Mini-XML and CUPS API documentation, the mxmldoc(1) program converts C and C++ source files into an intermediate XML format and uses in-line comments rather than comment headers to annotate functions, types, and constants. This chapter describes how to use it.
mxmldoc scans the specified C and C++ source files to produce an XML representation of globally accessible classes, constants, enumerations, functions, structures, typedefs, unions, and variables. The XML file is updated as necessary and a HTML representation of the XML file is written to the standard output. If no source files are specified then the current XML file is converted to HTML on the standard output.
In general, any C or C++ source code is handled by mxmldoc, however it was specifically written to handle code with documentation that is formatted according to the CUPS Configuration Management Plan which is available at "http://www.cups.org/documentation.php".