This is the third release of three wish-based tools:

  browser.tk - a configurable directory browser
  edit.tk - an extensible text editor
  help.tk - a multi-font help viewer

It also contains a pre-release copy of

  people.tk - an address book and mail alias manager

######################################################################
# WHAT'S NEW:
#
One big installation-related change since earlier releases is that all
of the applications now depend on procedures in a common library file,
jlibrary.tcl.  (This file can be installed in $tk_library like any
other Tk library, or it can be installed in the individual users
~/.tk  directory, for convenience, where it will be source'd.) The new
library contains a much nicer file-selection dialogue box, and some
other minor improvements.  (Needless to say, you are welcome to use
these routines, as-is or modified, in your own wish scripts.)

A number of procedures have had their names (and sometimes their
behaviour) changed in connection with their incorporation in the
library.  This will require changes in users' configuration files, I'm
afraid.  I haven't written a help file or man page for the library yet,
but comments in the library file should be clear.

Some major additions have been made to edit.tk, in particular two kinds
of automatic abbreviation-completion, inspired by Emacs' abbrev-mode
and dabbrev-mode.  Lots of other things have been added to edit.tk; for
a fuller list, see the new help file.

Changes to browser.tk are mostly bug fixes, although a few things have
been added (a distinction between Move... and Rename... commands, the
nicer file-selection box, etc.).  The browser now deals properly with
files with unusual characters in their names, like spaces.

A Preferences panel has been added to help.tk.

The work-in-progress directory in the distribution contains an alpha
version of an address-book program which writes alias files for Mail,
MH, and Elm.  It uses the file ~/.people, and you can explicitly load
and save to other files.  There isn't any documentation yet.

This directory also contains the beginnings of an edittkrc.tcl file for
dealing with formatted text, like that in the help files or the about
boxes.  This is _very_ preliminary.

######################################################################
# WHAT'S IN THE DISTRIBUTION:
#
Once you've untarred the distribution, you should have the following:

This README file.

The three wish scripts themselves (browser.tk, edit.tk, and help.tk)

Man pages for them (browser.tk.l, edit.tk.l, and help.tk.l)

A directory `tk' containing the library `jlibrary.tcl' and three
subdirectories: `help', `edit', and `browser'.  The `help' subdirectory
contains help files for all three applications, and each subdirectory
has a subdirectory `samples' which contains some example configuration
files.

A directory `work-in-progress' containing `people.tk' and 
`helptext_edittkrc.tcl'.

You must have installed the Tk toolkit in order to use these
applications.  They have been tested under version 3.2 of Tk.
Tk is available via anonymous ftp from sprite.berkeley.edu in the tcl
directory.

######################################################################
# HOW TO USE THEM:
#
To install:

Move the executable scripts wherever you want them to live (e.g.,
/usr/local/bin, or ~/bin).

If you are installing site-wide, move the library tk/jlibrary.tcl to
your local tk library directory, typically /usr/local/lib/tk, and run
the auto_makeindex tcl procedure in it to update the list of available
procedures.  (You can do this by typing "wish", and at the wish prompt
typing

  wish: cd $tk_library
  wish: auto_mkdindex $tk_library *.tcl

If you're just installing it for yourself, put jlibrary.tcl in your
~/.tk directory.

(If you want to do a quick-and-dirty installation of one of the tools,
without installing the library, you could also just prepend the library
to the appropriate file.)

Check that the tools run properly; you will need to change the path to
wish in the first line if wish is installed somewhere other than
/usr/local/bin/wish at your site.  (If your shell is csh or a
derivative, you will need to use the `rehash' command for the shell to
find the new commands.)

Move the man pages to an appropriate directory, such as
/usr/local/man/manl.  (If you decide to put them in a different
section, such as /usr/local/man/man1, remember to change the `.l' at
the end of the file names.)

If you're installing site-wide, put the _contents_ of the `tk'
directory from the distribution into your local tk library directory,
typically /usr/local/lib/tk.  You'll need to use `cp -R'; `edit',
`browser', and `help' are directories.  If you're just installing in
your own directory, you can just move the entire `tk' directory into
your home directory.

Comments, suggestions, and bug reports to js@it.bu.edu.