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

Guido van Rossum guido@CNRI.Reston.Va.US
Wed, 14 Aug 1996 15:32:08 -0400

> 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
> ftp://ftp.parc.xerox.com/pub/ilu/20/20a8-manual-html/manual_17.html#SEC27
> 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.

I like this idea a lot.

--Guido van Rossum (home page: http://www.python.org/~guido/)

DOC-SIG  - SIG for the Python Documentation Project

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