TranspositionCipherTool
by Andrew Lee

The TranspositionCipherTool is designed to help users decrypt a
transposition cipher.

Requirements:
To run, the Java 2 Runtime Environment v1.2.2 or above is required, as
well as the following files:

        TranspositionCipherTool.class
        TranspositionCipherTool$1.class
        Anagram.class
        AnagramThread.class
        FrequencyAnalysis.class
        InfoFrame.class
        NonEditableTableModel.class
        NonNegativeIntDocument.class
        TextFileReader.class
        TranspositionDimension.class

To compile, the Java 2 SDK v 1.2.2 or above is required, as well as the
following source code files:

        TranspositionCipherTool.java
        Anagram.java
        AnagramThread.java
        FrequencyAnalysis.java
        InfoFrame.java
        NonEditableTableModel.java
        NonNegativeIntDocument.java
        TextFileReader.java
        TranspositionDimension.java

Compilation:
1.  Obtain the source code.  Extract the .java source files from
    the TranspositionCipherTool.jar file if necessary.

    Use a zip archive utility or the following command:

        jar xvf TranspositionCipherTool.jar

2.  Go to the directory containing the following files:

        TranspositionCipherTool.java
        Anagram.java
        AnagramThread.java
        FrequencyAnalysis.java
        InfoFrame.java
        NonEditableTableModel.java
        NonNegativeIntDocument.java
        TextFileReader.java
        TranspositionDimension.java

3.  Execute the following command:

        javac TranspositionCipherTool.java

Execution:
To execute the TranspositionCipherTool do one of the following:

1.  If you have the compiled bytecode, use the following command:

        java TranspositionCipherTool

2.  If you have an executable jar file, use the following command:

        java -jar TranspositionCipherTool.jar

    or you may be able to simply double click the icon representing
    the .jar file if your OS supports the extension.

Menus:
File -> Open

        Loads a text file

File -> Save

        Saves the open text file using the current name

File -> Save As

        Prompts the user for the name of the file to save to


Tools -> Anagram
         
        Allows the user to anagram a set of letters.  The user sets up the
        parameters for the anagram.  The user then hits the Find Anagrams
        button which will bring up another window with a table of anagrams
        that meet the parameters the user specified.

        NOTE:  The dictionary file is a list of words, one word per line.


Help -> About Transposition Cipher Tool

        Displays an about frame.

Usage:
After loading a text file, the available dimensions (based on the number
of characters in the text file) can be changed to specify the rectangle
used.  In addition, the user can specify whether to load the text into
the display table by row or column.  Displaying by row means the text is
written left to right then to the next row.  This corresponds to writing
the ciphertext by row when creating it.  Displaying by column fills in
the table starting at the top of the first column, then down, then to the
top of the next column and so on.  This method corresponds to writing the
ciphertext by column when creating it.  The user can also count the
number of vowels by row or column.  (Note: When counting by column, the
column number refers to the column heading, not the columns position.)
Finally, the columns of the display table may be rearranged by dragging
the column by its heading to the desired location.  (Note: Tracking of
the mouse location seems to lag behind the actual location, so the speed
which a column is dragged may need to be adjusted accordingly.  The
actual position of the dragged column can be recognized by a "blank"
column between the other columns.)