[SciPy-dev] Latex and docstrings

josef.pktd@gmai... josef.pktd@gmai...
Thu Feb 18 09:22:38 CST 2010


On Thu, Feb 18, 2010 at 3:58 AM, Tom Grydeland <tom.grydeland@gmail.com> wrote:
> On Wed, Feb 10, 2010 at 3:12 AM, David Cournapeau <david@silveregg.co.jp> wrote:
>> Hi,
>>
>> I noticed that some of the docstrings I have written for DCT have been
>> changed to latex format. While I have no issue with having latex in the
>> documentation, I thought the consensus was to use them sparingly in
>> docstrings ?
>
> I knew I had seen this discussion before:
>
> http://mail.scipy.org/pipermail/scipy-dev/2009-February/010975.html
>
> Now, I'm not suggesting that my efforts in this are of any
> significance whatsoever, but it is annoying to have contributed
> something _upon_request_, and then having the exact same thing
> reverted, even to applause.
>
> If you don't want it, don't ask for it.

Before all the nice Latex disappears, can we rescue it and start a fft
tutorial page in scipy with the collection of all the formulas that
are currently in the docstrings?

I'd rather read rendered Latex than ASCII math expressions.

Josef

>
> --
> Tom Grydeland
>  <Tom.Grydeland@(gmail.com)>
> _______________________________________________
> SciPy-Dev mailing list
> SciPy-Dev@scipy.org
> http://mail.scipy.org/mailman/listinfo/scipy-dev
>


More information about the SciPy-Dev mailing list