[Numpy-discussion] something wrong with docs?
Mon Sep 21 13:32:40 CDT 2009
ma, 2009-09-21 kello 13:15 -0400, Skipper Seabold kirjoitti:
> On Mon, Sep 21, 2009 at 7:27 AM, Neal Becker <firstname.lastname@example.org> 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
> 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.
More information about the NumPy-Discussion