|
Packit Service |
50c9f2 |
Doxygen
|
|
Packit Service |
50c9f2 |
===============
|
|
Packit Service |
50c9f2 |
Doxygen is the de facto standard tool for generating documentation from
|
|
Packit Service |
50c9f2 |
annotated C++ sources, but it also supports other popular programming
|
|
Packit Service |
50c9f2 |
languages such as C, Objective-C, C#, PHP, Java, Python, IDL
|
|
Packit Service |
50c9f2 |
(Corba, Microsoft, and UNO/OpenOffice flavors), Fortran, VHDL, Tcl,
|
|
Packit Service |
50c9f2 |
and to some extent D.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Doxygen can help you in three ways:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
1. It can generate an on-line documentation browser (in HTML) and/or an
|
|
Packit Service |
50c9f2 |
off-line reference manual (in LaTeX) from a set of documented source files.
|
|
Packit Service |
50c9f2 |
There is also support for generating output in RTF (MS-Word), PostScript,
|
|
Packit Service |
50c9f2 |
hyperlinked PDF, compressed HTML, DocBook and Unix man pages.
|
|
Packit Service |
50c9f2 |
The documentation is extracted directly from the sources, which makes
|
|
Packit Service |
50c9f2 |
it much easier to keep the documentation consistent with the source code.
|
|
Packit Service |
50c9f2 |
2. You can configure doxygen to extract the code structure from undocumented
|
|
Packit Service |
50c9f2 |
source files. This is very useful to quickly find your way in large
|
|
Packit Service |
50c9f2 |
source distributions. Doxygen can also visualize the relations between
|
|
Packit Service |
50c9f2 |
the various elements by means of include dependency graphs, inheritance
|
|
Packit Service |
50c9f2 |
diagrams, and collaboration diagrams, which are all generated automatically.
|
|
Packit Service |
50c9f2 |
3. You can also use doxygen for creating normal documentation (as I did for
|
|
Packit Service |
50c9f2 |
the doxygen user manual and doxygen web-site).
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Download
|
|
Packit Service |
50c9f2 |
---------
|
|
Packit Service |
50c9f2 |
The latest binaries and source of Doxygen can be downloaded from:
|
|
Packit Service |
50c9f2 |
* http://www.doxygen.org/
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Developers
|
|
Packit Service |
50c9f2 |
---------
|
|
Packit Service |
50c9f2 |
* Build Status:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
* Coverity Scan Build Status:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
* Doxygen's Doxygen Documentation:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
* Install
|
|
Packit Service |
50c9f2 |
* Quick install see (./INSTALL)
|
|
Packit Service |
50c9f2 |
* else http://www.doxygen.org/manual/install.html
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
* Project stats: https://www.openhub.net/p/doxygen
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Issues, bugs, requests, ideas
|
|
Packit Service |
50c9f2 |
----------------------------------
|
|
Packit Service |
50c9f2 |
Use the bug tracker to report bugs:
|
|
Packit Service |
50c9f2 |
* current list:
|
|
Packit Service |
50c9f2 |
* [Bugzilla](https://bugzilla.gnome.org/buglist.cgi?product=doxygen&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED)
|
|
Packit Service |
50c9f2 |
* Submit a new bug or feature request
|
|
Packit Service |
50c9f2 |
* [Enter bug](https://bugzilla.gnome.org/enter_bug.cgi?product=doxygen)
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Comms
|
|
Packit Service |
50c9f2 |
----------------------------------
|
|
Packit Service |
50c9f2 |
### Mailing Lists ###
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
There are three mailing lists:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
* doxygen-announce@lists.sourceforge.net - Announcement of new releases only
|
|
Packit Service |
50c9f2 |
* doxygen-users@lists.sourceforge.net - for doxygen users
|
|
Packit Service |
50c9f2 |
* doxygen-develop@lists.sourceforge.net - for doxygen developers
|
|
Packit Service |
50c9f2 |
* To subscribe follow the link to
|
|
Packit Service |
50c9f2 |
* http://sourceforge.net/projects/doxygen
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Source Code
|
|
Packit Service |
50c9f2 |
----------------------------------
|
|
Packit Service |
50c9f2 |
In May 2013, Doxygen moved from
|
|
Packit Service |
50c9f2 |
subversion to git hosted at GitHub
|
|
Packit Service |
50c9f2 |
* https://github.com/doxygen/doxygen
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Enjoy,
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Dimitri van Heesch (dimitri at stack.nl)
|