[PYTHON DOC-SIG] Bill Janssen suggested...

Bill Janssen janssen@parc.xerox.com
Tue, 13 Aug 1996 16:37:35 PDT

As a new member of the documentation SIG, let me point out that it's
Bill Janssen, not `Bill Janseen', as the web page says.  You can find a
write-up on what I suggested (it's called TIM) at
5 (which, by the way, is written in TIM).

The basic idea is simple.  Let's take a reasonable markup source
language which has lots of tools to translate it into other formats, and
add a layer on top to support domain-specific markup.  We picked GNU
texinfo as a decent source form, from which text, HTML, Info, and
Postscript could be produced.  We then added a preprocessor layer to
translate domain-specific terms such as `@isl' (used to mark an ILU ISL
literal), to the domain-independent terms used by texinfo; for example,
`@isl' is translated to `@code'.  The preprocessor also drives the
transformation from texinfo to the desired output format, thereby
freeing the user from having to remember how to run TeX, etc.  Finally,
two domain-independent features are provided by TIM, and implemented in
the preprocessor.  They are the ability to include pictures in texinfo,
and the ability to add URL links.


DOC-SIG  - SIG for the Python Documentation Project

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