Chris Cannam, 2011-02-18 12:12 PM
h1. Documentation extracted from your code
If your project's repository contains code that is documented using either "Doxygen":http://doxygen.org or "Javadoc":http://download.oracle.com/javase/6/docs/technotes/guides/javadoc/, this site will automatically extract the documentation and make it available in a "Code docs" page for your project.
See the "Vamp Plugin SDK":/projects/vamp-plugin-sdk project for an example using Doxygen (look for the "Code docs" link in the navigation), or "Beatroot":/projects/beatroot for an example that uses Javadoc.
h2. How it works
Each night, a task runs which examines project repositories and checks whether they appear to contain either a @Doxyfile@ file (the configuration file for Doxygen) or Java source code, and if either is found, extracts the documentation using Doxygen or Javadoc and makes it available for the project.
h2. What if I don't want this?
If you have Java code or a @Doxyfile@ in your repository but you don't want documentation to be shown for your project, just switch it off in the project settings. Go to Settings -> Modules and uncheck "Embedded documentation (Javadoc or Doxygen)".
Note that this setting is off by default, but the documentation task switches it on automatically the first time it finds your project has some documentation to extract. If you subsequently switch it off again, it will stay off.
h2. Any problems?
Just "contact us":/projects/soundsoftware-site/wiki/Help#How-to-contact-us, we're happy to try to solve any problems you might have with this.