[PYTHON DOC-SIG] Re: [PYTHON MATRIX-SIG] Where to go (was Numerical Recipes)

Robin Friedrich friedric@rose.rsoc.rockwell.com
Mon, 21 Oct 1996 09:41:20 -0500

|> From: da@maigret.cog.brown.edu (David Ascher)
|> Subject: Re: [PYTHON MATRIX-SIG] Where to go (was Numerical Recipes)
|> To: jhauser@ifm.uni-kiel.de (janko hauser)
|> Date: Sun, 20 Oct 1996 15:30:32 -0400 (EDT)
|> Clearly this would make most sense if all Python docs were available in
|> a TIM-like format.  Maybe it's time to ask the DOC-SIG what's up.  The
|> Reference manual has been converted to FrameMaker, which might actually
|> allow conversion to SGML and from there TIM?  The other manuals were
|> last I checked available in info format (in fact it's with the library
|> reference in mind that I wrote the `ihelp' module, when some users were
|> complaining that Python had lousy help facilities compared to
|> matlab...).
|> --david

It should be made clear that the Language Reference and Tutorial
are the only docs converted to FrameMaker. The Lib Ref is still
up in the air as to format. The last view I heard was that it should
be written in a very easy system that's text-based and assembled
into it's entirety with some higher level tools. TIM looks to be the
odds on favorite here but there needs to be a whole lot more 
concurrence among module writers. The structured text standard
for doc strings needs to be considered and incorporated as well.
A TIM formatter for gendoc is an obvious approach.

DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org