Difference between revisions of "Doxygen Tutorials"
|Line 44:||Line 44:|
Revision as of 18:41, 12 August 2017
This is a simple tutorial with some tips on how to use Doxygen to document codes and how to show the HTML page.
What is Doxygen
Doxygen is a tool to generate documentation from source code. It is primarily used for C++ codes, but it also supports other popular programming languages such as C, Objective-C, C#, PHP, Java, Python, IDL, Fortran, VHDL, Tcl, and to some extent D. You can see more information here.
You can download the Doxygen here.
How to document you code
In order to generate Doxygen documentation, you need to comment the code in a specific way. You can take a look at this page to see more information on how to comment your code.
How to see the HTML page on SourceForge
When you comment your code using the Doxygen style, after compiling, it generates an HTML page.
However, you may want to see the result of the HTML page, not its code. A way to do that is to look at the Source Forge site using the Anonymous Access. Basically, using the Anonymous Access you have access to a ready-only page, where you can visualize the result of the HTML. You can access the Source Forge project in this way using:
If your project has sub-projects, you will need to use:
After to be in you repository page, you only need to find the page with de Doxygen documentation and click on the 'index.html' file.
To better illustrate it, let's use the Little John as an example. We have the project 'macro@ufmg' in Source Forge. Under 'macro@ufmg', we have the sub-project 'Little John', and then the repositories 'AX18 Smart Robotic Arm', 'Mobile Base' and 'Mobile Manipulator'.
So let's choose the repository 'Mobile Manipulator'. The Source Forge page using the Anonymous Access is then
Accessing this page you will see something like this:
In the case of the repository 'Mobile Manipulator', the file 'index.html' is in the following path:
So the page with the generated HTML will be