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

Linux (x86, glibc) version,
Java JDK/JRE 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: Linux (x86), tested on:
  Fedora Core 4/8/10/11/12, Debian 5, SuSE 10/11,
  Ubuntu 8/9, and Mandriva 2009.1.
  For MS Windows there is a separate distribution.

- Requires 3 MB of disk space.

- To run this program, Sun JDK/JRE 1.1 or
  greater or compatible is needed. The Sun 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)
  Notes:
   On 64-bit OS the program will run only with 32-bit Java.
   In recent Linux distributions only Java 1.5, 1.6, and 1.7
   are working; and you could use IcedTea/OpenJDK
   with small problems.

INSTALL
-------
1. Extract this archive into temporary directory.

2. Edit "install" script to reflect your Java VM.
   Run it from the temporary directory
   in xterm (it runs under X Window).
   The script will start the wizard and according to your
   choices, the CPT Word Lists program will be installed.
   You could run it as root/su to be able to set
   'All Users' in the installation dialog 'Desktop Menu Folder'
   (but under su/sudo never set 'Current User'
   if you don't work usually as root.)

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;
   - ~/CPT_U directory for the uninstall program
   (see UNINSTALL below).
   Note that the user running the program should have
   full access to the installation directory.
   If you run KDE or GNOME, the following menu files
   will be created:
    ~/.config/menus/applications-merged/cptwl142.menu
    ~/.local/share/desktop-directories/cptwl142.directory
    ~/.local/share/applications/cptwl142_sc0.desktop
    ~/.local/share/applications/cptwl142_sc1.desktop
    ~/.local/share/applications/cptwl142_sc2.desktop
   If started as root/su and 'All Users' selected:
    /etc/xdg/menus/applications-merged/cptwl142.menu
    /usr/share/desktop-directories/cptwl142.directory
    /usr/share/applications/cptwl142_sc0.desktop
    /usr/share/applications/cptwl142_sc1.desktop
    /usrlocal/share/applications/cptwl142_sc2.desktop
   and the CPT_U directory will be created as:
    /home/CPT_U

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 the installation fails, you still can extract
   the program from data.zip file.

6. If you have problem running CPT Word Lists,
   check/modify the generated cpt_wl142 script to
   reflect your JDK/JRE environment, especially
   if you install a new version of JRE after you have
   installed this program (e.g. for Java after 1.3.0 you
   should add -noverify flag)

7. You can edit the wl142_doc script, to choose
your favorite browser for the HTML documentation.


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

1. Click on the 'uninstall' item added to the
   desktop menu.
   Do not use the menu as normal user
   if you have done the installation as root/su,
   or you have to delete manually the menu files
   from the system directories as root/su.

2. In xterm go to your ~/CPT_U and run
   ./juninst <inst-dir>/UnInst
   where <inst-dir> is the path where you
   installed the program.
   If you have done the installation as root/su,
   you should run the script as root/su as well
   from /home/CPT_U directory.

If you have installed a new version of JRE after
the installation of this program, check/modify
'juninst' in your ~/CPT_U subdirectory.

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.


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
