Tcl Data transformations (Tcl-Trf)
		(Version 2.1.4 / MAY-06-2009)

		Andreas Kupries	(andreas_kupries@users.sourceforge.net)

This directory contains a freely distributable extension to Tcl/Tk called Tcl
Data transformations (Tcl-Trf). The collection of provided transformation
procedures includes:

*	Generation of message digests (hash values, checksums)

	MD2, MD5, SHA/SHS, SHA-1, HAVAL, RIPEMD-128, -160
	CRC (polynomial used by PGP)
	ADLER (based upon zlib)

*	Conversion from and to various data encodings:

	dual, octal, hexadecimal representation
	uuencoding, base64-encoding, ASCII85-encoding

*	A reed-solomon error correcting coder.

*	(De)Compression based on zlib 1.0.4 or higher (1.1.3 is current)
	(if available as shared library)

*	Data encryption:

	Was removed from the base package, but is available
	separately (TrfCrypt).


Example applications distributed with the package are:

*	'tools/md', a message digest generator.
	Upwardly compatible to 'md5sum'.

Tcl-Trf is developed for Tcl 7.6 or higher.  It is a pure Tcl extension,
Tk is not required.  The extension requires a patched core. Patch files
for 7.6, 8.0 and 8.0a2 are part of the distribution.  The plus-patches
maintained by Jan Nijtmans (nijtmans@nici.kun.nl) contain this patch too .

Supporting (optional) packages are:

*	memchan 1.0  or higher (required by testsuite, by same author)

	See	http://www.oche.de/~akupries/soft/memchan/

*	zlib-1.0.4   or higher (1.1.3 is current!)

	See	http://www.cdrom.com/pub/infozip/zlib/

*	SSLeay or OpenSSL

	See	http://www.ssleay.org/
	or	http://www.openssl.org/

Packages built upon the fundament provided by Trf are

*	TrfCrypt, contains various encryption systems, by myself.

	See	http://www.oche.de/~akupries/soft/trfcrypt/

*	TLS, an SSL/TLS implementation for all valid Tcl channels,
	by Matt Newman <matt@novadigm.com>

	See	http://www.sensus.org/tcl/tls.htm
		http://www.sensus.org/tcl/tls11.tgz


This distribution contains the source code for Tcl-Trf + documentation
describing commands (-> latex) and c-level interfaces (-> man-pages).



COMPILING/USING Tcl-Trf

To compile Tcl-Trf please follow the instructions in the HTML
documentation (file: doc/html/trf_compile.html).

To report bugs, bug fixes, descriptions of interesting Tcl-Trf
applications, and suggested improvements:

+) Send email to andreas_kupries@users.sourceforge.net

or

+) Post an article to the newsgroup	comp.lang.tcl


PLATFORMS
	tested:
		Linux 2.0.29	(gcc 2.7.2.3)	Development system
		IRIX 6.2	(cc only)
		ULTRIX 4.1	(both cc and gcc)
		ULTRIX 4.4	(cc 3.0)
		HP-UX-9		(both cc and gcc)
		HP-UX-10.2
		Solaris 2.5	(gcc only)

	Other machines and OS's should work too.

Feedback about other OS's and compilers is appreciated. Please
help me in making this package better.

		Tcl Data transformations (Tcl-Trf)
		(Version 2.1.4 / MAY-06-2009)

		Andreas Kupries	(andreas_kupries@users.sourceforge.net)

This is the README file for the TEA compliant building of the Trf
extension.

Please follow the instructions in the HTML file

	doc/html/trf_ctea.html

for compilation and installation of this package, independent of wether
you are on a Unix or Windows machine. Beware that in case of Windows TEA
uses the Cygwin tools from Cygnus (www.cygnus.com) for compilation and
linking.

After that, enjoy it.