making python man pages looks hard

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


"Magnus L. Hetland" wrote:
> 
> connolly at w3.org (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
> www.python.org/doc/doc:
> 
>   "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.
latex2esis.py
esis2sgml.py

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 man.py")

-- 
Christian Tismer             :^)   <mailto:tismer at appliedbiometrics.com>
Applied Biometrics GmbH      :     Have a break! Take a ride on Python's
Kaiserin-Augusta-Allee 101   :    *Starship* http://starship.python.net
10553 Berlin                 :     PGP key -> http://wwwkeys.pgp.net
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