[Numpy-discussion] Question for Pauli or Stefan about doc editor.

Charles R Harris charlesr.harris@gmail....
Wed Apr 15 19:13:44 CDT 2009


On Wed, Apr 15, 2009 at 6:05 PM, Robert Kern <robert.kern@gmail.com> wrote:

> On Wed, Apr 15, 2009 at 19:03, Charles R Harris
> <charlesr.harris@gmail.com> wrote:
> >
> > On Wed, Apr 15, 2009 at 4:50 PM, Robert Kern <robert.kern@gmail.com>
> wrote:
> >>
> >> On Wed, Apr 15, 2009 at 16:27, Charles R Harris
> >> <charlesr.harris@gmail.com> wrote:
> >> > Hi Pauli,
> >> >
> >> > I'm going to move the docstrings from mtrand.pyx to add_newdocs.py.
> Will
> >> > this require any fixes to the doc editor so that the docs don't get
> >> > readded
> >> > to mtrand?
> >>
> >> IIRC, David has told me that recent Cythons will do the right thing
> >> with the docstrings. It would be easier simply to build mtrand.c with
> >> Cython instead of Pyrex. It would be cleaner to keep the docstrings
> >> attached to the source.
> >
> > Are Cython and Pyrex still close enough to be interchangeable?
>
> David and others have built it so before.
>
> > I also like
> > the idea of having all the docs in add_newdocs so that no one has to go
> > looking for them. I would even prefer having the python function docs
> there
> > ;)
>
> Ugh. I really, really don't.
>

OK, I just ran mtrand through cython-0.9.8.1.1,  which is probably horribly
outdated, and it does break up the strings. So that is a possibility. Anyone
else want to express a preference as to where the docs should go?

Chuck
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/numpy-discussion/attachments/20090415/c0ea92ea/attachment.html 


More information about the Numpy-discussion mailing list