Generate HTML Documentation

Top  Previous  Next

The Generate HTML Documentation feature allows you to generate a file with documentation of your source code in HTML format. This is accomplished by transforming the XML file generated by the Generate XML Documentation feature into an HTML file using an Extensible Stylesheet Language Transformation (XSLT) file.

An XSLT file is supplied with MZ-Tools. You can customize this XSLT file to meet your needs (for example, you may want to remove some information from the output).

You can specify the name of the XSLT file used for the transformation in the Corporate Options window, Generate HTML Documentation section.

MZ-Tools offers the following ways to generate HTML documentation:

  • The MZ-Tools | Other Utilities | Generate HTML Documentation... menu.
  • The Other Utilities | Generate HTML Documentation... menu on the MZ-Tools toolbar.
  • The keyboard shortcut associated with the MZTools6_VSXXXX.GenerateHTMLDocumentation command.

When you invoke this feature, a dialog window is shown that allows you to select the scope of the operation and the name of the output file.

Remarks:

  • Ensure that the source code can be compiled without errors before running this feature.
  • The HTML file is generated with the encoding that you specify in the XSLT file, in the <xsl:output> node. For example, if you set:

 

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

<xsl:output method="html" encoding="utf-16" />

Then the HTML file will be generated with Unicode (UTF16) encoding.

See Also:

Generate HTML Documentation Options

Generate XML Documentation

Keyboard Shortcuts Options