Installation

Generally, you should run the application Setup (or the install script for Linux) and follow the wizard. The notes below are supplied as Readme.txt in the distributions and should be used if you have a problem. CPT programs are written in Java and you should have Sun JDK/JRE 1.1-1.7 or MS JVM (jview) to install and run the programs.

The Sun Java Runtime Environment is available for download at: java.sun.com (version 1.1.8 is 5 MB, 1.6.0_xx is 16 MB.) On 64-bit OS you should use 32-bit Java for the current versions of CPT applications.

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.

Installation under Microsoft Windows

This section is about the program versions CPT Crosswords 1.1/1.1.1/1.2/1.3, CPT Word Lists 1.4/1.4.1/1.4.2, and CPT Dictionary 1.4/1.4.1/1.4.2. The programs are tested on Microsoft Windows 95/98/ME/NT/XP/Vista/7.

1. Extract the zip file into temporary directory.
2. Run Setup.exe. This will start the wizard and according to your choices, the program will be installed. 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 programs are 'single user applications' and the user running the program should have full access to the installation directory.
4. If you have problem running an application, check/modify the generated *.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 Windows 2K/XP is:
c:\Documents and Settings\user-name
for NT it is:
c:\winnt\Profiles\user-name
for ME or single user Windows 95/98 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 the 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 one:
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 CptDictionary.cfg:
Diction
#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_dc14.jar) is built-in into the corresponding launcher and it is not included in the 'cfg' file.


Installation under Linux

This section is about the program versions CPT Crosswords 1.1/1.1.1/1.2/1.3, CPT Word Lists 1.4/1.4.1/1.4.2, and CPT Dictionary 1.4/1.4.1/1.4.2. The programs are tested on Fedora Core 4/8/10/11/12, Debian 5, SuSE 10/11, Ubuntu 8/9, and Mandriva 2009.1.
In recent Linux distributions only Java 1.5, 1.6, and 1.7 are working; and you could use IcedTea/OpenJDK with small problems.

1. Extract the archive into temporary directory.
2. Edit the '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 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 (for CPT Dictionary 1.4):

~/.config/menus/applications-merged/cptdc14.menu
~/.local/share/desktop-directories/cptdc14.directory
~/.local/share/applications/cptdc14_sc0.desktop
~/.local/share/applications/cptdc14_sc1.desktop
~/.local/share/applications/cptdc14_sc2.desktop
If started as root/su and 'All Users' selected:
/etc/xdg/menus/applications-merged/cptdc14.menu
/usr/share/desktop-directories/cptdc14.directory
/usr/share/applications/cptdc14_sc0.desktop
/usr/share/applications/cptdc14_sc1.desktop
/usrlocal/share/applications/cptdc14_sc2.desktop
and the CPT_U directory will be created as:
/home/CPT_U

4. If the installation fails, you still can extract the program from data.zip file.
5. If you have problem running the CPT application, check/modify the generated script (e.g. cpt_dc14) 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)
6. You can edit the *_doc script, to choose your favorite browser for the HTML documentation.

UNINSTALL
To uninstall, do one of the following:
- 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.
- 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 sub-directory.
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.