[Numpy-discussion] something wrong with docs?
Tue Sep 22 14:13:04 CDT 2009
On Tue, Sep 22, 2009 at 12:02 AM, Pauli Virtanen <firstname.lastname@example.org> wrote:
> I think sphinx.ext.doctest is able to also test the ordinary >>> marked-
> up examples, so there'd be no large need for new directives.
Well, >>> examples intermix input and output, and are thus very
annoying to paste back into new code or interactive sessions (ipython
has %doctest_mode that helps some, but you still have to avoid pasting
output). Furthermore, >>> examples get very unwieldy beyond a few
lines, and things like class definitions are hard to do and read in
The nice thing about the sphinx full doctest support is that it scales
very well to more complex code blocks.
More information about the NumPy-Discussion