Python para todos

Documentación
Una vez hecho esto podemos acceder a la documentación de todos
los módulos disponibles abriendo la página http://localhost:puerto en
nuestro navegador.
Por último, mediante el flag -g podemos lanzar una interfaz gráfica
para buscar documentación que utiliza el servidor HTTP para mostrar
los resultados.
Epydoc y reStructuredText
El problema de pydoc es que es muy simple, y no permite añadir
semántica o modificar estilos de la documentación. No podemos, por
ejemplo, indicar que en una línea en concreto de entre las líneas de
documentación de la función describe un parámetro de la función o
mostrar un cierto término en cursiva.
Existen proyectos para generar documentación con funcionalidades
más avanzadas como Docutils, Epydoc o Sphinx, aunque es necesario
aprender sintaxis especiales.
Docutils es un proyecto desarrollado por David Goodger que incluye
distintas herramientas para generar documentación utilizando
el formato reStructuredText, un formato de texto plano creado por
el mismo autor, y que es el formato más utilizado en la comunidad
Python. reStructuredText se utiliza, entre otros, para la creación de los
PEPs (Python Enhancement Proposals).
Sin embargo, actualmente Docutils es más indicado para generar
documentos a partir de archivos de texto, y no a partir de docstrings
extraídos de código fuente Python, ya que el parser encargado de este
trabajo dista mucho de estar terminado.
EpyDoc es una de las herramientas de generación de documentación
para Python más utilizadas. Además de texto plano y de su propio
formato, llamado epytext, soporta reStructuredText y sintaxis Javadoc,
cosa que los programadores Java agradecerán.
A lo largo del resto del capítulo utilizaremos reStructuredText como
127