[Python-Dev] that library reference, again (original) (raw)

Brett Cannon bcannon at gmail.com
Mon Dec 26 21:02:01 CET 2005


On 12/26/05, Fredrik Lundh <fredrik at pythonware.com> wrote:

as seen on the doc-sig:

> > > javadoc's > > > > > > {@link os.popen} > > > > > > is even shorter. > > > > > > hmm. maybe a combination of rest/html/whatever and pythondoc markup > > > would be the ultimate tool for the library reference... > > > > <* heavy clapping sound of my footsteps while running away screaming in fear *> > > really? since everything that has people running in fear is worth investigating further, I've spent a few hours putting together a first iteration of a "python.org library reference to a javadoc-ish source format converter". more info here: http://effbot.org/zone/pythondoc-lib.htm including goals, non-goals, and 2.5 megabytes of converted (but not yet properly rendered) library pages.

Not specifically advocating the solution, but the markup looks reasonable and easy to use. Thanks for taking a stab at this, /F.

-Brett



More information about the Python-Dev mailing list