A.29 STAR_XML_DOCUMENTATION

STAR_XML_DOCUMENTATION(documentcode, [targets=''])

Generate the standard makefile targets to handle XML documentation source. The parameter documentcode should be something like `sun123' -- it should not include any .xml extension.

For details, see the macro STAR_LATEX_DOCUMENTATION, which this macro closely matches, and which is more often used. The differences are as follows:

• The default list of targets is .texml_tar .htx_tar .ps .pdf, though using the second argument (discouraged) requires you to specify values for the JADE, SGMLNORM and SGMLKIT_HOME substitution variables (the .texml_tar tarball contains a .tex file plus any required figures).
• This macro defines the substitution variables @STAR_XML_DOCUMENTATION@ and @STAR_XML_DOCUMENTATION_<DOCUMENTCODE>@.
• This macro declares a dependency on the sgmlkit component.
• The interface to LATEX2DVI is the same, and configure option --without-stardocs suppresses this documenation, too.