mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 14:50:19 +00:00
Added document ref to Sphinx. Inserted links at the Epydoc text.
This commit is contained in:
@@ -193,6 +193,10 @@ Multi-line docstrings: ::
|
||||
if imag == 0.0 and real == 0.0: return complex_zero
|
||||
...
|
||||
|
||||
|
||||
.. _sphinx-ref:
|
||||
|
||||
|
||||
Sphinx
|
||||
------
|
||||
|
||||
@@ -220,14 +224,16 @@ should help you familiarize yourself with its syntax.
|
||||
Other Tools
|
||||
:::::::::::
|
||||
|
||||
|
||||
Epydoc
|
||||
------
|
||||
Epydoc generates API documentation based on docstrings.
|
||||
Epydoc is able to parse docstrings marked up with reStructuredText, Javadoc,
|
||||
plaintext or epytext. It supports various output formats, most notable HTML,
|
||||
PDF or LaTeX documents.
|
||||
`Epydoc <http://epydoc.sourceforge.net/>`_ generates API documentation based on docstrings.
|
||||
Epydoc is able to parse docstrings marked up with :ref:`reStructuredText-ref`,
|
||||
`Javadoc <http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html#javadocdocuments>`_,
|
||||
`epytext <http://epydoc.sourceforge.net/manual-epytext.html>`_ or plaintext.
|
||||
It supports various output formats, most notable HTML, PDF or LaTeX documents.
|
||||
|
||||
The development of Epydoc is discontinued. You should use Sphinx instead.
|
||||
The development of Epydoc is discontinued. You should use :ref:`sphinx-ref` instead.
|
||||
|
||||
pycco / docco / shocco
|
||||
----------------------
|
||||
|
||||
Reference in New Issue
Block a user