As well as doxygen, apple has a tool the comes with the development tools. It generates the type of documentation you see on things like the SystenConfiguration framework. The tool is called HeaderDoc the documentation can be found in the HeaderDoc User Guide.
