INTRODUCTION
============
I am a member of the American Cryptogram Association (Nom:  WART) and a
self-proclaimed computer geek.  These two interests naturally came together
and as a result, I now have a fairly large set of code for displaying,
manipulating, analyzing, and in some cases solving a variety of
cipher types.  All of the cipher types present in this package are
best described in the Handbook for Members of the American Cryptogram
Association, "The ACA and You".

Many of the cipher types also have programs or scripts that will
solve them with little user intervention.  I find it a very interesting
exercise to write autosolvers.  However, using them without having any
knowledge as to how they work is pointless.  Therefore, the autosolvers
are provided as a proof of concept only.

REQUIREMENTS
============
The interface uses the Tcl/Tk toolkit provided by Ajuba Solutions (formerly
Scriptics Corporation).  You will need to install Tcl/Tk before you
will be able to compile this software.  Development was done using
Tcl/Tk versions 8.3.1, but all of the programs except tkcrithm should work
with any version 8.0 or later.

If you install from the binary RPM, make sure to add the environment
setting "TCLLIBPATH=/usr/local/lib" to your login environment.  This will
ensure that the various script programs can find the Tcl cipher package
that was installed.

Some sample ciphers are also included.  They were taken from various 
issues of the Crytpogram, a publication of the American Cryptogram 
Association.

Current cipher types that are supported are:

*#Aristocrat
* Autokey
*#Baconian
* Bazeries
*#Beaufort
* Bifid
* 6x6 Bifid
*#Cadenus
*#Complete/Incomplete columnar transposition*
*#Cryptarithm
  Grandpre
*#Grille
*#Gronsfeld
*#Homophonic
* Morbit
*#Myszcowski
* Nicodemus
*#Nihilist transposition
*#Patristocrat (display as aristocrat)
* Phillips
* Playfair
*#Pollux (gui interface currently broken)
*#Porta
*#Railfence
*#Redefence (solve as myszcowski)
*#Route Transposition
*#Swagman
* Trifid
*#Variant
*#Vigenere

Types tagged with '*' have an option or supporting script that will attempt
to solve the cipher (or come pretty darn close to it).

Types tagged with a '#' can be displayed and manipulated using the
graphical tool.

Documentation is avaliable in the doc directory.  Run "make doc" to generate
html files from these sources.

I'm always adding new cipher types and improving on the programs' abilities
to manipulate the existing ones.  If you have any comments/complaints/tips/etc.
please don't hesitate to mail me at wart@kobold.org.  I'm always looking for
more ways to improve the program.

--Wart
wart@kobold.org
September 30, 2000