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.
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 wjviewAnd here is a sample CptDictionary.cfg:
Diction #C:\Program Files\Java\jre6\bin C:\Util\jre7\bin javaw -noverifyIf 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.
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.desktopIf 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.desktopand the CPT_U directory will be created as:
/home/CPT_U
./juninst [inst-dir]/UnInstwhere [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.