							Gteborg 1998-01-13

   TkRat software and its included text is Copyright 1996,1997,1998
   by Martin Forssn.

   The full text of the legal notices is contained in the file called
   COPYRIGHT, included with this distribution.



	PORTABILITY

This software should work on any Unix-system where you can build tcl/tk.


	BUILDING THE SOFTWARE

TkRat depends on tcl7.5 and tk4.1 or later so these must be installed.

	run './configure'

This will configure the makefiles etc. See INSTALL for options
to configure.
Configure depends on you having tclsh7.5 and wish4.1 or later in your path.
If configure fails to locate the tcl/tk include-files or libraries you might
have to modify lib/Makefile. At the top of that file are the definitions
needed.
If configure fails to find tclConfig.sh or tkConfig.sh you can use the
--with-tcl-config=DIR and/or --with-tk-config=DIR arguments to point
at their locations.

	do a 'make'

This should build the software.
You might want to test the software before installing it. This is done
with the following command: '../scripts/tkrat (you must have either the
tkrat or the lib directory as current directory when you try this). For
development support there is ../script/setup. if you source that file from a
csh-based shell you can then just start ../lib/tkrat.exec as long as your
CWD is either tkrat or lib.


	do a 'make install'

This will install the program in /usr/local/bin. The destination can
be overridden with the --prefix argument to configure in the first step.

The program will install one script (in $prefix/bin) and a number of library
files and a binary in (in $prefix/lib/tkratlib). The path to the library
files will be stored in the script, but can be overridden at runtime by
setting the RATLIBDIR environment variable to point at the real location.

You can change the name of the program and the directory for the library
files by using the --program-prefix and --program-suffix arguments to
configure.


	CONFIGURATION

You can have site-wide configuration files etc. Configuration issues
are covered in the CONFIGURATION file.


	PERMISSIONS of /var/spool/mail

TkRat expects /var/spool/mail to have permissions drwxrwxrwt. That is
everybody has write access but the sticky bit is on. It is NOT safe
to make TkRat setgid or setuid.


	TCL MINIMIZERS SUPPORT

The configure script tests if you have frink or tcl_cruncher installed.
If you have one of them then it will be used. They will "compile" the
installed tcl-files by removing all unnecessary white-space.


	DELIVERY STATUS NOTIFICATIONS (DSN)

TkRat supports DSN as defined in rfc1891-4. This requires that messages are
sent via ESMTP and that the MTA (mail transfer agent) also supports DSN
(otherwise you will not get DSN support, TkRat will still work though).
Actually all MTA's the message will pass through must talk DSN for it to
work fully (otherwise you will just get DSN's with the action field set to
forwarded).


	CURRENT INFORMATION

This software has a webpage at http://www.dtek.chalmers.se/~maf/ratatosk
This page should always contain up to date information abut tkrat.
There is also a mailinglist on which announcements of new versions are
posted. To subscribe send a mail to ratatosk-announce-request@dtek.chalmers.se.
There is also a discussion list which you can subscribe to at
ratatosk-request@dtek.chalmers.se (announcements are posted to both lists).
Currently I handle all sunscription requests manually so have patience
when subscribing.
To send messages to this list send them to ratatosk@dtek.chalmers.se


	ACKNOWLEDGEMENTS

I would like to thank all those people who has helped me test TkRat. Special
thanks goes to Erik Stenvall the poor alfa-level tester who often was the
first one to get bitten by those nasty bugs.
I would also like to thank Tristan Tarrant who did the Italian version of
all the texts.


	POSTCARDS

TkRat is free to use, I do not require anything from any of its users. But
I do not mind getting postcards. In fact I think it is a great way to keep
track of how far it has spread. So if you like TkRat (and you want to) you
can send me a postcard from where you live. I have the following address:

Martin Forssen
Kabalegatan 13c
41457 Gteborg
SWEDEN


	BUGS (aka UNDOCUMENTED FEATURES)

Please report any found bugs to maf@dtek.chalmers.se


	AUTHOR's ADDRESS

The author (thats me) can be reached at maf@dtek.chalmers.se
I live in the city of Gteborg in Sweden.
