OK, thanks for the comments, I'll change the syntax you suggested.
Which version of numpydoc is required?


On Fri, Jul 19, 2013 at 8:33 AM, Varoquaux <notifications@github.com> wrote:

> In doc/README.rst:
>
> > +
> > +Building the ``matplotlib`` package
> > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> ~~~~~~
> > +
> > +Begin by building the ``matplotlib`` package, using the command
> > +
> > +::
> > +
> > +    python setup.py build
> > +
> > +from the `root <..>`__ of the source tree.
> > +
> > +Building the documentation
> > +~~~~~~~~~~~~~~~~~~~~~~~~~~
> > +
> > +To build the HTML documentation, ``sphinx`` (version >= 1.0) is
>
> numpydoc is also required to build the docs. It should be mentionned here.
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/matplotlib/matplotlib/pull/2227/files#r5291935>
> .
>



-- 
Dr. David P. Sanders

Profesor Titular "A" / Associate Professor
Departamento de Física, Facultad de Ciencias
Universidad Nacional Autónoma de México (UNAM)

dpsanders@gmail.com
http://sistemas.fciencias.unam.mx/~dsanders

Cubículo / office: #414, 4o. piso del Depto. de Física

Tel.: +52 55 5622 4965