[Numpy-discussion] something wrong with docs?

Pauli Virtanen pav at iki.fi
Mon Sep 21 14:32:40 EDT 2009


ma, 2009-09-21 kello 13:15 -0400, Skipper Seabold kirjoitti:
> On Mon, Sep 21, 2009 at 7:27 AM, Neal Becker <ndbecker2 at gmail.com> wrote:
> > I'm trying to read about subclassing.  When I view
> >
> > http://docs.scipy.org/doc/numpy/user/basics.subclassing.html?highlight=subclass#module-
> > numpy.doc.subclassing
> >
> > It seems the examples show the _outputs_ of tests, but I don't see the
> > actual example code.
> >
> > e.g., the first example renders like this:
> >
> > Simple example - adding an extra attribute to ndarray¶
> > Using the object looks like this:
> >
> 
> I'd like to see this sorted as well.  The problem is that the
> `testcode` directive
> <http://docs.scipy.org/numpy/docs/numpy-docs/user/basics.subclassing.rst/>
> is not recognized.  I was recently a bit confused by this, and I went
> to the rst file to view the code, but that's obviously not a fix for
> the rendering problem.

The `sphinx.ext.doctest` extension is not enabled, so the testcode::
etc. directives are not available. I'm not sure if it should be enabled
-- it would be cleaner to just replace the testcode:: stuff with the
ordinary example markup.

-- 
Pauli Virtanen






More information about the NumPy-Discussion mailing list