1 .. -*- coding: utf-8; -*-

     2 .. include:: HEADER.rst

     3 

     4 =========================

     5  Source code documenting

     6 =========================

     7 .. contents::

     8    :local:

     9 

    10 About

    11 =====

    12 

    13   http://en.wikipedia.org/wiki/Comparison_of_documentation_generators

    14 

    15 Doxygen

    16 =======

    17 

    18 Doxygen is a documentation generator for C++, C, Java, Objective-C, Python,

    19 IDL (CORBA and Microsoft flavors), Fortran, VHDL, PHP, C#.

    20 

    21   http://www.doxygen.org

    22     Home page.

    23   http://en.wikipedia.org/wiki/Doxygen

    24     Wikipedia page.

    25 

    26 DOC++

    27 =====

    28 

    29 DOC++ is a documentation system for C, C++, IDL and Java generating both TeX

    30 output for high quality hardcopies and HTML output for sophisticated online

    31 browsing of your documentation. The documentation is extracted directly from

    32 the C/C++/IDL header/source files or Java class files.

    33 

    34   http://docpp.sourceforge.net/

    35     Home page.

    36 

    37 ROBODoc

    38 =======

    39 

    40 ROBODoc is a documentation tool. It extracts the documentation from your source

    41 code and formats it in HTML, RTF, TeX, XML DocBook (PDF), or ASCII. Works with

    42 C, C++, Fortran, Perl, Scripts, Assembler, Tcl, Basic, and any language that

    43 supports remarks.

    44 

    45   http://sourceforge.net/projects/robodoc

    46     Home page.

    47   http://en.wikipedia.org/wiki/ROBODoc

    48     Wikipedia page.