« Previous -
Version 7/11
(diff) -
Next » -
Current version
Trond Lossius, 2012-08-27 01:58 pm
Adding info on Graphviz for Mountain Lion
Using Doxygen for API Documentation¶
Doxygen is a documentation system for C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors), Fortran, VHDL, PHP, C#, and to some extent D. It is used for documenting parts of the source code for the various Jamoma projects, although not as much as we would like to...
Setting up Doxygen¶
To use it, you will have to download and install:
- Doxygen - version 1.6.0 or later
- Graphviz
- Graphviz for Mac OSX - we currently use version 2.14.1. Instructions on how to set up Graphviz with Mountain Lion can be found below.
- "graphviz for Windows
Generating Doxygen documentation¶
This description was written using Mac, but hopefully it is similar on Windows.
- Open the Doxygen application
- From the File menu, choose Open... and inside your local clone of the GIT repository locate e.g.
/Modules/Foundations/documentation/Doxfile
- All settings should be fine, so go to the Run tab and click the Run doxygen button. If you have generated documentation previously, you might want to throw out the
/Modules/Foundations/documentation/html/
folder first.
Using Doxygen documentation¶
- A number of articles on Doxygen can be found here.
- Online Doxygen documentation of the Jamoma projects is available here.
Setting up Graphviz with OSX Mountain Lion¶
- Open Terminal and type
which dot
- If you get a reply to this, Graphviz is already installed.
- If not you can install it using either Homebrew or MacPorts.
- Once Graphviz is installed you'll need to tell Doxygen where to look for it:
- IN Terminal, type the command
which dot
- In Doxygen, provide the path to Graphviz as illustrated below.
- IN Terminal, type the command