[Python-Dev] The docs, reloaded
g.brandl at gmx.net
Sun May 20 23:30:13 CEST 2007
Scott Dial schrieb:
> Neal Becker wrote:
>> Sounds very interesting. I just have one concern/question. I hope that
>> while moving away from latex, we are not precluding the ability to write
>> math as part of the documentation. What would be my choices for add math
>> to the documentation? Hopefully using latex, since there really isn't
>> AFAIK any other competitor for this.
> Where in the current documentation is there any math notation /at all/?
> In all my reading of it, I have not run across anything that appeared
> like it was being used. Besides that question, is the full power of
> LaTeX math notation really necessary here? I somehow doubt anything more
> than simple expressions of runtime performance and container behaviors
> are appropriate for any documentation we have.
There is exactly one instance of LaTeX math in the whole docs, it's in the
description of audioop, AFAIR, an contains a sum over square roots...
So, that's not really a concern of mine ;)
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.
More information about the Python-Dev