AQTOOLS VERSION 0.2002.01.26 INSTALLATION INSTRUCTIONS

This directory contains version 0.2002.01.26 of the aqtools (formerly
jstools) package.  This is an interim snapshot release.

Please send bug reports and comments to me, <js@aq.org>.  (I know 
the documentation is thoroughly broken at the moment, though. :-)

IMPORTANT: This version of the jstools suite *requires* version
8.0 (preferably 8.1 or greater) of Tcl/Tk.  It runs with most
functionality under Unix, and the editor at least is usable under Windows
(although some things don't quite work).  I don't know whether it runs
on a Mac.

INSTALLATION

To install aqtools, just run the aqinstall.tcl wish script in this
directory, fill in the fields properly (help is available within the
script), and click on the `Install' button.  If "./aqinstall.tcl" doesn't
work for you, try "wish8.3 ./aqinstall.tcl" or "wish ./aqinstall.tcl".

If you don't have wish or the X Window System available when you're
installing jstools, you can run the aqinstall script under tclsh8.3
(e.g. with "tclsh8.3 ./aqinstall.tcl").

You can add "--prefix <prefixdir>", "--wish <path_to_wish>",
"--tclsh <path_to_tclsh>" and a few other flags to the invocation
of ./aqinstall.tcl to change the defaults.  If you're *not* using Tk
(if you're running aqinstall with tclsh), then you can add "--auto 1"
to perform the installation automatically, without asking any questions.

DOCUMENTATION

You probably should ignore the documentation in this interim release. :-/

Documentation is included in jdoc or jhtml format, which are rich-text
formats supported by aqedit.  The documentation gets installed when
you copy ./lib (or it gets found under $AQSTOOLS_LIB).  You can type
"aqdoc" to get a list of (cryptically-named) topics to choose from.
The documentation is in pretty sorry state at the moment, as mentioned
above; in particular, the document still refers to the old names of
files and commands - for instance, "jstools" instead of "aqtools".

I'm now also distributing the documentation in HTML format, converted
from aqdoc format by the procedures in lib/pkg/aqtagconvert.tcl, which now
have some support for hypertext links.  You should be warned that some of
the formatting (whitespace in particular) is lost.  In this release (in
contrast to previous releases), internal hypertext links, i.e. to other
points within the same document, are preserved in the generated HTML.
I hope to further improve the HTML generation in future versions.

Jay Sekora
<js@aq.org>
2002.01.26