estilo de los comentarios

[Chema Cortes]

El 7/11/06, camontuyu<camontuyu en yahoo.es> escribió:
> Chema Cortes escribió:
> > Se usa mucho el doxygen, sobre todo en proyectos grandes donde se
> > combinen varios lenguajes de programación. Pero ya que pides una
> > recomendación, usa pydoc con el parser reStructuredText (incluído en
> > docutils <http://docutils.sourceforge.net>). Entre otras cosas, se
> > puede combinar con doctest para realizar pruebas automáticas, o
> > generar gráficos tales como fórmulas matemáticas expresadas en LaTeX.
>
> Has comentado que se pueden incluir fórmulas expresadas en latex, pero
> en la documentación de reStructuredText no he encontrado nada, como se
> pondrían las formulas?

Se presentó en la PyCon de este año. Aparece como noticia al inicio de
la web de docutils. Las fórmulas se introducen como una nueva
"directiva" (extensiones del reStructureText).


> ¿Alguna otra maravilla?

Todavía ando descubriendo cosas. Lo mejor es que te pasees por la
documentación de docutils y las vayas descubriendo poco a poco. En el
"sandbox" de docutils se pueden encontrar algunas joyas:

  http://docutils.sourceforge.net/sandbox/

Por ejemplo:

  <http://docutils.sourceforge.net/sandbox/tibs/pysource/>

También espero mucho de este otro proyecto:

  http://pudge.lesscode.org