INSTRUCTIONS FOR THE SIMPLE SUBSTITUTION CIPHER
                         KEY 1 CREATOR
                                
This program has been provided for the user's entertainment and can be used freely and
modified as the user wishes.

After downloading the zipped files (source code and executable program) into a temporary
storage area (such as My Briefcase), create a file for permanent storage in which you can unzip
the files with a program such as Zipmagic 2000.  This is the program that I used to zip the two
files.

Once the files are unzipped, double click on the executable program icon and bring up the
introduction screen.  This gives the names of the people involved in the writing of the source
code.  After reading the introduction, press any key to continue to the next screen.

This screen gives the rules of encipherment used by the ACA using a K1 simple substitution
cipher.  After reading these rules, go to the next screen by pressing any key.

This screen continues the rules as set forth by the ACA.  After reading, press any key to
continue.

This screen gives an example of what this program does and in much the same format.  After
reading, press any key to continue.

This screen asks you to enter the keyword that you wish to use to encipher your message.  It
doesn't make any difference whether it is in upper or lower case letters as the program
automatically sets your keyword to uppercase.  The program automatically adds the regular
alphabet to the keyword and eliminates any duplicates leaving a keyed 26-letter alphabet.  After
entering your keyword, press "Enter" to continue.

This screen asks that you examine the plain and cipher alphabets visually to determine if there
are any matches.  That is, is there a plain alphabet letter represented by itself in the cipher
alphabet.  If there is, you will need to shift the plain alphabet.  You will need to press any key to
continue.

This screen continues the instructions for shifting the alphabet.  Press any key to continue.

In this screen, enter a number between 1 and 25.  This will shift the plain alphabet by that
amount.  Visually examine the alphabets and continue shifting as necessary.  When you are
satisfied with both alphabets, enter 0 (zero) to break out the shift routine.

You are now asked to enter the plaintext message that you wish enciphered.  You can use most
all punctuation except the apostrophe.  Due to Pascal's peculiarity, the accent mark(found on
most keyboards above the "tab" key and below the "~", must be used instead.  It looks enough
like the apostrophe so that it shouldn't cause any problems.  When you have finished entering
the plaintext, press "Enter" to continue.

You are now asked to provide a crib for other people to use as an aid to help in solving your
cipher.  Use the same rules as for the plaintext entry.  The crib will be automatically enciphered. 
If you do not wish to provide a crib, press the space bar and then press "Enter".

The keyed plain alphabet and straight cipher alphabet with proper shift will be displayed as well
as the plaintext, the ciphertext, the crib (if any) and its caesar encipherment.  Since this is a dos
based program, press "Shift & Print Screen keys together".  Be sure to have your printer on to
avoid an error message.  Your work should print out and you can submit this as a contribution to
the proper editor for publication in "The Cryptogram".

Programming notes:

A dos version of Pascal was used in this program.  The source code shows all variables with the
description for those variables.  I have used one method for changing lower case letters to upper
case.  You can probably use something simpler and shorter.  Take time to look over the code for
the various procedures.  I had problems with the shift procedure until Mr. Russell Atkinson
showed me how to eliminate them.  I'm still fairly new to cryptography programming.    The
other procedures were developed by experimentation.  Don't ever be afraid to experiment with
coding techniques.  It's the only way you will ever learn.

Good luck and have fun with the program.  I plan to create K2, K3, and K4 cipher programs in
the future.

Archie Bullington
"The Flying Dutchman"