Tools: HeaderDoc User's Guide: Major Features

## 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

© 1999, 2004 Apple Computer, Inc. All Rights Reserved. (Last updated: 2004-10-27)