[SciPy-dev] Latex and docstrings

David Goldsmith d.l.goldsmith@gmail....
Fri Feb 19 15:30:34 CST 2010


Hi, folks!  OK, at this point, can someone(s) please summarize precisely
where changes have been made as a result of this thread?  (I don't need to
know what the changes were, of course, 'cause I can get those from the
Wiki.)  Thanks!

DG

On Fri, Feb 19, 2010 at 6:24 AM, <josef.pktd@gmail.com> wrote:

> On Fri, Feb 19, 2010 at 8:05 AM, Tom Grydeland <tom.grydeland@gmail.com>
> wrote:
> >> On Fri, Feb 19, 2010 at 2:45 AM, Tom Grydeland <tom.grydeland@gmail.com>
> wrote:
> >>> Do you want me to fix the latex errors?
> >
> > On Fri, Feb 19, 2010 at 1:24 PM,  <josef.pktd@gmail.com> wrote:
> >> Yes, please, and make any adjustment that you find usefule.
> >
> > Okay, they are fixed, and I unified all the references cited also.
> >
> >> I didn't want to copy too much from the numpy docs since we can also
> >> just refer to it. For my reading an abridged explanation refering to
> >> the numpy docs, and a more complete collection of the extra parts that
> >> in scipy would be useful. But we haven't had much discussion yet on
> >> doc duplication between scipy and numpy (which is also relevant for
> >> the descriptions of the distributions in numpy.random and
> >> scipy.stats.distributions)
> >
> > I'm fine either way, but I think for a tutorial page for fftpack it
> > seems odd to define the DCT in that level of detail and then refer
> > elsewhere for the DFT definition.
>
> I don't have a strong opinion either.
> The numpy.fft module docstring is short enough (when rendered on the
> webpage) that most of it can be repeated. My initial thought was that
> fft in scipy could be explained more in terms of fft2 and fftn, with
> examples for those. (I just recently struggled with fftn and there is
> not much example code available.)
> I think, the definitions and formulas should be included for all
> transforms in any case.
>
> Josef
>
> >
> >> Josef
> >
> > --
> > Tom Grydeland
> >  <Tom.Grydeland@(gmail.com)>
> > _______________________________________________
> > SciPy-Dev mailing list
> > SciPy-Dev@scipy.org
> > http://mail.scipy.org/mailman/listinfo/scipy-dev
> >
> _______________________________________________
> SciPy-Dev mailing list
> SciPy-Dev@scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/scipy-dev/attachments/20100219/6ca07385/attachment.html 


More information about the SciPy-Dev mailing list