Documenting Your Code Errata
Some things have changed since I wrote the article, here's a quick update (download files at the bottom of the page).
- doxygen (1.3.6) and graphviz (1.12) now have Aqua interfaces available versions available. Check the doxygen website (www.doxygen.org) for doxygen and the pixelglow website (www.pixelglow.com/graphviz/) for graphviz. These applications contain command line binaries inside of them and you can use them from the command line. The doxygen binary is inside Doxygen.app/Contents/Resources and the dot binary is inside Graphviz.app/Contents/MacOS. Adding these directories to your path or adding links from these files into directories in your path should do the trick. However, the graphviz software does spit out some errors (a Component Manager error) and no longer supports gif files. It will correctly generate png files despite the error.
- doxygen (1.3.4) and graphviz (1.9-11) can be installed using Fink if you really don't want a graphical interface.
- The doxygen 1.3.4 version configuration files can be updated when they are passed to doxygen 1.3.6.
- The default shell for new users in Mac OS X 10.3 is now bash. I have been able to use the chsh command from both bash and tcsh to switch shells back and forth. Executing chsh from the command line will put you in an editor. You can use hjkl to move left, down, up right respectively. Type i to move to insert mode. Type [esc] to leave editing mode. Then type :w (colon w) to write out the file and :q (colon q) to quit the editor. If that sounds pretty hairy, you may find NetInfo Manager (in /Applications/Utitilies) easier to work with. Select users, then your username and edit the shell information (you will need to authenticate). If you use NetInfo Manager, you may need to log out and log back in before the change is reflected. If you use chsh in the terminal, the next terminal window you open will reflect the change. Alternatively, you could learn to use bash (I've heard it is very nice), but I cannot help you much with it, I've always used csh or tcsh.
- The instructions for adding a doxygen stage to Project Builder project work fine with XCode.
Last Update: September 9, 2010