[Numpy-discussion] documenting index_tricks

[Ralf Gommers]

On Sun, May 24, 2009 at 3:48 PM, Pauli Virtanen <pav at iki.fi> wrote:

> Sun, 24 May 2009 19:21:59 +0000, Pauli Virtanen wrote:
>
> > Sun, 24 May 2009 14:29:30 -0400, Ralf Gommers wrote:
> >
> >> Hi all,
> >>
> >> I'm documenting the index_tricks module and am unsure how to handle r_
> >> and related objects. r_ is an instance of RClass, therefore ipython
> >> shows the RClass docstring for "r_?". RClass in the doc editor is also
> >> marked as "needs editing", and the page for r_ is completely empty (see
> >> http://docs.scipy.org/numpy/docs/numpy.r_/#numpy-r). It seems like only
> >> one of the two should be edited and then the docstring should be copied
> >> over. In Travis Oliphant's Guide to Numpy r_ is extensively documented,
> >> should I integrate part of that with one of the docstrings?
> >
> > Yes, please reuse the r_ documentation, and write it on the
> > numpy.lib.index_tricks.r_ page. We already do special tricks to get the
> > mgrid and ogrid docs to work as they should, and it's simple to do the
> > same for r_ and c_.
>
> I'm wrong: the correct place is RClass, since its only instance is r_.
>

Thanks Pauli and Josef. I'll edit RClass and put a comment on the r_ page
that it should not be edited and has to be removed from the doc editor at
some point. Josef is right about the r_ page already showing up correctly in
the sphinx generated docs.

Ralf
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20090524/8bd8978e/attachment.html>