[Numpy-discussion] SphinxDocString class in new numpy doc framework
Sun Jun 29 21:17:01 CDT 2008
I guess this question is mostly for Stefan... but I am trying to port the
scikits.timeseries module wiki documentation into a sphinx framework, and
trying to follow the numpy doc string standards (which can't be parsed
by sphinx), so I'm trying to use the SphinxDocString class in
docscrape_sphinx.py to pre-process the doc strings. However, the doc strings
not seem to be getting processed correctly. I didn't dig deep into the
but I thought I'd ask first before I go any further in case I am approaching
this incorrectly all together.
If I try to process the numpy.swapaxes docstring for example, I get the
following output (note the formatting of the parameters):
>>> print SphinxDocString(np.swapaxes.__doc__)
Return a view of array a with axis1 and axis2 interchanged.
**a** : array_like
axis1 : int
axis2 : int
>>> x = np.array([[1,2,3]])
>>> x = np.array([[[0,1],[2,3]],[[4,5],[6,7]]])
I don't know if the SphinxDocString class is even ready for use yet or not,
this didn't look right to me.
The other thing I was wondering is if anyone knows how to pre-process doc
strings on the fly such that you can mix them in with your .rst files
how the autodoc sphinx extension works (rather than just pre-generating a
dump of all the doc strings into a single .rst file). This is probably a
question more for the sphinx mailing list, but I thought I'd ask while I'm
the topic in case anyone has any quick tricks they can share.
View this message in context: http://www.nabble.com/SphinxDocString-class-in-new-numpy-doc-framework-tp18187697p18187697.html
Sent from the Numpy-discussion mailing list archive at Nabble.com.
More information about the Numpy-discussion