------------------------------------
CPT Word Lists 1.4.2

Windows 32-bit version, Sun's Java JDK/JRE
or MS JVM (jview)  required.

Shareware, runs in demo mode until registered.
Freely distributable.

Updated: 30-April-2010
------------------------------------

DESCRIPTION
-----------
CPT Word Lists is collection of tools for processing word
lists and text files, supporting Unicode and unlimited number
of encodings via the Java converters. Its main goal is
to create dictionaries for the other CPT programs
but it can be used as completely independent program.

Features:

The set of operations over textual (plain text or HTML)
files include:
- browsing/searching in any standard encoding including
  decomposition and bidi support;
- extracting words, calculating letter and word frequencies;
- flexible 'word' definition and filtering;
- changing the encoding and the letter case, transliterating;
- standard Unicode and custom normalizations;
- visual/logical order conversion for RTL scripts;
- simple spell checking and tagging.

The word lists (text or dictionary format) operations
include the above plus:
- creating highly compressed dictionaries optionally
  including tags, definitions and pictures (one million words
  can be stored in a browsable, less then 1MB file);
- several types of sorting including user defined
  order and alphabets (90 alphabets supplied);
- compare/add/delete functions over dictionaries;
- global assignment of tags and extracting
  subsets via filters;
- automatic or user defined suffixes packing;
- via user definitions: creating and expanding
  munched lists, creating and filtering tagged lists,
  translating tags in tagged lists, tagging;
- searching and extracting word patterns;
- creating inverted indexes;
- 3 levels of protecting the dictionaries.

More details can be found in the HTML documentation.
The differences with the old versions are listed in Changes.txt.

There is a supporting program CPT Dictionary
for browsing the files created by CPT Word Lists.
CPT Dictionary is free for non-commercial use and
you can distribute it together with your dictionaries.


SYSTEM REQUIREMENTS
-------------------
- Supported OS: Windows 95/98/ME/NT/2K/XP/Vista/7
  (for Linux there is a separate distribution);
- Requires 3 MB of disk space;
- This is Java program and Sun's JDK/JRE 1.1 or
  greater or compatible is needed. The Sun's Java
  Runtime Environment is available for download at: 
  http://java.sun.com/products/
  (version 1.1.8 is 5 MB, 1.6.0_xx is 16 MB)
  If you prefer MS JVM (jview was included in all Windows
  versions till the end of 2004), we have to note that MS JVM
  has faster GUI but supports limited number of character encodings.
  On 64-bit OS this program will run only with 32-bit Java.


INSTALL
-------
1. Extract this zip file into temporary directory.

2. Run Setup.exe.
   This will start the wizard and according to your
   choices, the CPT Word Lists program will be installed.
   If you have older version of the program,
   the new version should be installed in
   different directory.
   If Setup.exe gives an error, this means that the launcher
   was not able to find the Java installation and
   you should create/edit Setup.cfg file
   (see CPT Java Launcher below).
   Under Vista/7 additionally, you have to point out
   that this is trusted application to be able to run it.

3. The installation program (install.class) is a
   self-extracting class file whose contents get
   extracted during the installation and two
   directories will be created:
   - the target one chosen for the installation;
   - <user-home>\CPT_U directory for the uninstall program
   (see UNINSTALL below).
   Note that CPT Word Lists is 'single user application'
   and the user running the program should have
   full access to the installation directory.

4. During the installation you will be asked for a
   License Key, if you don't have, leave the field
   empty - the program will run in Demo mode. In this
   mode the size of word lists/dictionaries is
   limited to 500 words, the optional Thai
   composition will not be available, and 
   'All Files in Source Directory' menu item
   will be disabled.

5. If you have problem running CPT Word Lists,
   check/modify the generated CptWordLists.cfg file to
   reflect your JDK/JRE environment.
   The Java console window is closed after
   starting the program. If you want to keep it,
   you should change "javaw" to "java"
   or "wjview" to "jview"
.


UNINSTALL
---------
To uninstall, do one of the following:

-  Click on the uninstall icon added to the
   start menu or desktop folder.

-  Go to the Add/Remove Programs dialog
   (Programs and Features on Vista)
   in the Windows Control Panel and remove the program.

-  Run:
   <user-home>\CPT_U\Uinstall.exe <CPT-home>\UnInst
   where <CPT-home> is the installation directory,
   and <user-home> for Win 2K/XP is:
     c:\Documents and Settings\<user-name>
   for NT it is:
     c:\winnt\Profiles\<user-name>
   for ME or single user Win 95 it is:
     c:\windows
   for Windows Vista/7 it is:
     c:\Users\<user-name>\AppData\Roaming\Microsoft\Windows
   but it is hidden for the Windows Explorer and you have
   to set this program to show the hidden files
   (Organize|Folder and search options|View tab|Advanced settings).

Again, under Vista/7, you have to point out that
Uinstall.exe is trusted application to be able to run it.

After the uninstallation the CPT_U directory
will not be removed because it serves all CPT
packages. If you don't have any other CPT
program, you can delete it.
Under Windows Vista you may need to remove the
Crossword Power Tools folder from the 
start menu as well (manually, because
the user permission is required).


CPT Java Launcher
-----------------
All exe files in this distribution are just
Java launchers. The launcher checks the registry
to find out your Java installation and lunches the JVM.
A configuration file is also supported.
For example, the Setup.exe looks for Setup.cfg file
in the same directory and reads the settings for the JVM.
The 'cfg' file should have 3 lines,
and an optional fourth line:
1. The application class name
2. The path to the JVM directory
3. The name of the JVM exe file
4. Optional parameters for the JVM
Here is a sample Setup.cfg:
install
C:\Windows\system32
wjview
And here is a sample CptWordLists.cfg:
WordLists
#C:\Program Files\Java\jre6\bin
C:\Util\jre7\bin
javaw
-noverify
If the line starts with '#', it is ignored.
The launcher also checks if the JVM exe file exists,
and if not, looks in the registry and updates
the 'cfg' file.
This means also that if there is no 'cfg' file,
it will be created by the launcher.
The name of the jar file (e.g. cpt_wl142.jar)
is built-in into the corresponding launcher
and it is not included in the 'cfg' file.


LICENSE AND REGISTER
--------------------
Check out the License.txt and register\Register.txt for
license and register information.


CONTACT
-------
We are very interested in receiving your comments,
suggestions, and bug reports at our email:
support@cpt-crosswords.com
