making python man pages looks hard

Christian Tismer tismer at
Fri Aug 20 23:42:00 CEST 1999

"Magnus L. Hetland" wrote:
> connolly at (Dan Connolly) writes:
> >
> > The source format is LaTeX. Converting from LaTeX is hard/messy:
> Well - the docs aren't in standard LaTeX, are they? According to
>   "With almost no basic TeX or LaTeX markup in use, [...] the markup
>   syntax is about the only evidence of LaTeX in the actual document
>   sources."
> Since the format seems to be clearly and simply defined, it shouldn't
> be *that* difficult... Anyway - a transition to XML seems to be on its
> way, which will make all this trivial. (Actually, it wouldn't be that
> hard to go from the HTML versions either, I guess, with a little
> imagination. My point is - there is no reason to be spooked by the
> complexity of LaTeX here...)

In I:\cvsroot\python\dist\src\Doc\tools\sgmlconv
I find some README and a couple of scripts.

and it looks to be able to produce XML. ?

Then I'd take an XML parser and try to generate man pages :-)
I have just no idea of *that* format.

ciao - chris     (starting a "who writes the shortest")

Christian Tismer             :^)   <mailto:tismer at>
Applied Biometrics GmbH      :     Have a break! Take a ride on Python's
Kaiserin-Augusta-Allee 101   :    *Starship*
10553 Berlin                 :     PGP key ->
PGP Fingerprint       E182 71C7 1A9D 66E9 9D15  D3CC D4D7 93E2 1FAE F6DF
     we're tired of banana software - shipped green, ripens at home

More information about the Python-list mailing list