ANN: MAXTAL INTERSCRIPT version 1.0a7 RELEASED 13 Nov 1998
----------------------------------------------------------

Maxtal Interscript is an advanced literate programming system, 
designed to support integrated development of code and documentation. 
It requires CPython 1.5.1 [http://www.python.org] to operate, 
and benefits from availability of some Posix features and common tools.

Version 1.0a7 has undergone significant rearchitecting: instead
of a single Python script, it is now Python package, with a tiny
command line launcher. This should enable a GUI launcher to be
easily written for the Mac (or any other windowing system).

Interscript also has quite a few new features. These include:

  Tables
  Unit testing with diff of expected output
  Standard auxilliary indices of
    identifiers
    classes
    functions
    unit tests
    code sections

  Full Python tokeniser with partial parsing 
    to support auxilliary index generation.
  Multipass convergence testing with status report
  Persistent storage
  C accelerator module
  Enhanced HTML META information
  Fully scoped frame architecture for client script
  Cross referencing
  CSS1 style sheets for HTML
  MIE DOM support for table of contents
  Documentation partitioned into 
    Requirements 
    Design 
    Tutorial, and 
    Implemententation

Browse Documentation
--------------------

You will find the complete HTML documentation for 
Interscript version 1.0a7 at

  http://www.triode.net.au/~skaller/interscript

This is an experimental alpha release and is provided for
evaluation purposes only.

You can browse the <A HREf="iscr_top.html">advanced web</A> version,
which consists of many small pages, uses frames, and includes 
several special indexes. The table of contents of this version
provides dynamic folding on browsers using the Microsoft
Internet Explorer Document Object Model.

Maxtal Interscript can also produce documentation in a simple,
monolithic, single page. This version is not available for
browsing online because it is too big -- about 2Megs!

Download the package
--------------------

You can download Maxtal Interscript using anonymous FTP.

  ftp://ftp.triode.net.au/ftp/skaller/interscript.tgz
  
is the complete Maxtal Interscript package as a gzipped, tarred, archive.
The tarball is about 1.5 Meg, and includes ready to run Python script, 
the full interscript sources, and the complete documentation in web,
flat html, plain text, and latex format. Unpack this archive
somewhere Python can find it.

[This package has also been posted to the 'incoming' directory of

  ftp.python.org

with the name:

   interscript_1_0_a7.tgz

to facilitate faster downloading, I will advise the address on
that site when it becomes available there.]

Feedback
--------

Please 

  mailto:skaller@maxtal.com.au
  
to contact the author, John Skaller.

OSS Licence
-----------

Software on the FTP site is available free for any use, 
except where components are, or are derived from, third party components,
in which case the licence for those components applies. 
The following Maxtal components are so encumbered: 
tokenise.pak (LINL), dm.pak (free for non-SPAM use).
The grammar module was derived from PyLR with permission from the author.

Commercial Support
------------------

I will consider any requests for commercial support.
Please feel free to contact me if you're considering a serious
investment in literate programming.