This section basically lists known limitations of HeaderDoc
8. We hope to improve in these areas in future versions. If you
find issues not listed here, please file bugs.
- The man page
output path is currently somewhat manual. To convert a header, etc.
to a set of man pages, do something like the following:
headerdoc2html [flags] -X filename.h
mv filename/*.1 /path/to/man/man1
- HeaderDoc 8 is somewhat slower than previous versions. This
is because the entire parser has been rewritten from the ground
up and now does a token-based parse of the input file.
this should significantly improve the correctness of output (colorizer
bugs notwithstanding), it is doing a lot more work than before,
and thus takes longer. We do still hope to improve other aspects
of performance in future versions, however.
- HeaderDoc’s default color scheme matches XCode coloring.
There are a number of files supplied as alternative color schemes,
ranging from pleasant to utterly hideous and blinking (used mainly
for testing). Swap out your headerDoc2HTML.config file as desired.
- GatherHeaderDoc’s default template is built-in. The format
for this template is described in “Using GatherHeaderDoc”.
Also see “Example gatherHeaderDoc Template” for an example of the template format.
© 1999, 2004 Apple Computer, Inc. All Rights Reserved. (Last updated: 2004-05-27)