Before reporting a bug, first check the home site to make sure you're
using the latest version of TkMan.  If you send me bug reports and/or
suggestions for new features, include the versions of TkMan, Tcl, Tk,
X, and UNIX, your machine and X window manager names, the edited
Makefile, a copy of your ~/.tkman file, and the first few lines of the
`tkman' executable.  Otherwise don't waste my time.


*** INSTALLING ***

TkMan 1.8 is based on Tcl 7.5 and Tk 4.1 and will not work with
earlier versions.  Tcl and Tk are available for anonymous ftp from
ftp.smli.com.  TkMan expects a UNIX-like man page directory structure.

Be sure to read through the Makefile as there are pieces throughout
the top half of it that you may wish or need to customize for your
site.  Set BINDIR in the Makefile to where you keep your binaries (the
`tkman' script goes here), and MANDIR to the directory where the
TkMan's manual page should be copied.  After properly editing the
Makefile, type `make install'.  Thereafter type `tkman' to invoke
TkMan (perhaps after a `rehash').


SUN SOLARIS, SGI IRIX, SCO, IBM AIX
These systems store manual pages in nonstandard ways.  Each of
Solaris, SGI IRIX and SCO requires a special bindings file found in
the contrib directory.  TkMan automatically installs the appropriate
binding file for new users (those without a ~/.tkman startup file);
otherwise one can manually integrate the bindings into an existing
startup file.  Random System V based OS'es should follow the example
for SGI.  IBM AIX'ers should convert InfoExplorer format man pages to
the standard /usr/man/cat* format using the procedure described in
section 7 of the document /usr/lpp/bos/bsdadm.


--------------------------------------------------

Be sure to look in the contrib directory for lots of good stuff.

--------------------------------------------------
