[Python-Dev] The docs, reloaded
Neal Becker
ndbecker2 at gmail.com
Tue May 22 01:41:48 CEST 2007
skip at pobox.com wrote:
>
> >>> What would be my choices for add math to the documentation?
>
> >> Where in the current documentation is there any math notation /at
> >> all/?
>
> Georg> There is exactly one instance of LaTeX math in the whole docs,
> Georg> it's in the description of audioop, AFAIR, an contains a sum
> over Georg> square roots...
>
> Georg> So, that's not really a concern of mine ;)
>
> You must realize that people will use the core tools to create
> documentation
> for third party packages which aren't in the core. If you replace LaTeX
> with something else I think you need to keep math in mind whether it's
> used in the core documentation or not.
>
Perhaps my comment was misunderstood. I have no objection to a new system,
and it does not have to be based on latex. I just hope there will be some
escape mechanism that allows math. It happens that for math markup, there
isn't really anything better (or more familiar) than latex.
More information about the Python-Dev
mailing list