Major Features

HeaderDoc 8 has a number of new features.

• Function/data type groupings

• Declaration syntax coloring

• New tagless syntax

  /*! This is a comment about what comes next */

• Support for HeaderDoc tags embedded in declarations

• Support for //! markup style for embedded HeaderDoc declarations

• Automatic linking of data types in declarations

• Improved C++ support (namespace/template/access)

• GatherHeaderdoc is now template based

• PHP support (and a bunch of other languages) now included without patching

• Support for linking to other methods and data types within the same file

• Comment stripper

• Support for exceptions

• Now warns if tagged parameters don’t match declaration

• Optional warning if parameters are not tagged

• Improved warnings for other invalid content

• Man page output path (via XML)

• DTD for output validation

• Translation of HTML to XHTML using xmllint when using XML output

• Nested class handling

• Customizable date format

• C pseudoclass support (typedef struct)

• Better nested class support

• C++ constructors/destructors now sorted first in the list of class methods.

• The @ignore tag—allows you to remove matching tokens from declarations

• “Unsorted” flag

• Summary function and method lists (a mini-TOC)

• Automated detection of numbered lists

• Automatic handling of availability macros

• Improved overall appearance

• Beginnings of a regression test suite