[DOC-SIG] Re: [PSA MEMBERS] [XML] Notes on the Tutorial's markup

[Bill Janssen]

I seem to keep having to say this every couple of years...

Just use TIM
(ftp://ftp.parc.xerox.com/pub/ilu/2.0a11/manual-html/manual_21.html),
which is a Texinfo-based system that produces either text, Postscript,
or HTML.  It can be easily munged to produce XML instead of, or in
addition to, HTML, if desired.  In distinction to Texinfo, TIM supports
pictures and URLs just fine, and supports application-specific generic
markup (you can say @French{mais oui!} instead of @i{mais oui!}), it's
easier to type than XML (@emph{indeed!} instead <EMPH>indeed</EMPH>),
it's free, and the tool chain already works.

Bill

_______________
DOC-SIG  - SIG for the Python Documentation Project

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