INSTALLATION
============

	Tknews requires Tk3.3 and Tcl7.0 to run correctly.  If you have
older version of the Tcl/Tk package things may or may not work, I make
no guarantees.  I believe, however, that the scripts will work fine with
either tcl7.0 or tcl6.7.  The C source, however, is only compatible with
Tcl7.0 right now... making it compatible with Tk3.2 would not be too
hard.  

	Tknews uses its own version of the wish program, with many
extensions added to the interpreter for reading and retrieving news.
Because of this, you'll have to compile a binary for your system.

	The sources for tknews are found in the src directory.  Inside
this directory are the source files, an Imakefile, and a normal
Makefile (called Makefile.noimake).  You shouldn't have to modify the
source files, but you'll almost certainly want to change the definitions
for SCRIPT_DIR and LIBRARY_DIR in the Imakefile or the Makefile, depending
on which you decide to use.  If possible, use the Imakefile, as it
will produce a makefile more customized to your system.  However,
either way, you'll probably have to install tknews
by hand because I haven't figured out how to tell imake where to put
support files (if anyone has any hints on this let me know).

	Installing tknews by hand isn't very tough, though.  Just decide
on a place to put the tknews directory, and copy the "scripts" and "lib"
directories from the distribution into that directory.  Make sure that
these directories corrospond to the locations specified in the Makefile
for SCRIPT_DIR and LIBRARY_DIR when you compiled tknews.

==============
RUNNING TKNEWS
==============
	
	To run tknews, you need to configure it.  Configuration is done
through the config.t script in the scripts directory of the distribution.
Each configuration option is explained with comments, so if you read
through the file carefully you should be able to set things up for
your system.  Some of the major decisions you have to worry about are
whether you're going to use an nntp server or a spool directory, what
method you will be using to post messages, etc....

	There are three example config.t files provided in the examples
directory to give you an idea of how different setups are achieved.

	Once you have modified the config.t script to reflect your
site, you should be able to run tknews.  If you have problems, first
make sure the SCRIPT_DIR and LIBRARY_DIR defines are pointing to the
correct directories.

---------

	If you have any problems with getting tknews to run on your
system, please let me know and I'll try and help you as best I can.

	Sincerely,

	-Michael Moore
