el sistema de documentación que estoy usando para la
versión de pilas en python.
El sistema se llama sphinx, y actualmente lo utilizan muchos
proyectos de software libre:
http://sphinx.pocoo.org/

Así es como básicamente se instala:
- Código: Seleccionar todo
sudo easy_install sphinx
y dependiendo de la distribución usar uno de estos dos
comandos (el primero para ubuntu-debian y el segundo para arch).
- Código: Seleccionar todo
sudo apt-get install texlive-full
sudo pacman -S texlive-most
Y aquí cito algunos que tutoriales que mencionan a sphinx:
- Sintáxis básica: http://packages.python.org/an_example_p ... phinx.html
Tutorial general de documentación: http://pylonsbook.com/en/1.1/documentation.html
Tips y buenas reglas para documentar con sphinx: http://tarekziade.files.wordpress.com/2 ... ter-10.pdf
Integración con c++: http://sphinx.pocoo.org/domains.html#id1
Ojalá les guste el sistema de documentación y les resulte útil.
Cualquier duda me pueden consultar.