dklibs-win32
Dirk Krause's software for Win32
Readme file for the Win32 port

Readme file for the Win32 port

Licensing
Additional installation steps
Configuration data is not removed by uninstall

Licensing

Overview
License terms for dklibs-win32
License terms for the used libraries

Overview

The dklibs-win32 package contains software for Windows (executable programs). Source code from different packages/projects was used to build the programs. You are bound to the license terms of all the involved packages/projects when using dklibs-win32:

License terms for dklibs-win32

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License terms for the used libraries

The dklibs-win32 package uses the following libraries:

The programs bmeps.exe and fig2vect.exe and the libraries bmeps.lib, bmeps.dll, dkbif.lib and dkbif.dll use the following additional libraries: The programs kls.exe, kls-xp.exe and snmpyalc.exe use the following additional library: The programs klpr.exe, klpq.exe, klprm.exe, klpq.exe and snmpyalc.exe and the libraries yanolc.lib and yanolc.dll use the following additional library:

Additional installation steps

Inspect PATH environment variable
Use Windows XP version of kls.exe
Correct mkpdfsls.pl script
Customize font configuration for fig2vect's SVG output driver
Configure access to LPD print servers
Install Java run-time environment
Initialize Java preferences system

Inspect PATH environment variable

Note: As I have a german Windows version on my computer I do not know the exact texts shown by Windows versions in other languages.
May be button names... on your Windows version may differ a little bit from the texts shown here.
The PATH environment variable lists directories to search for executable programs and DLLs. Directories are separated by semicolon.
In the system control choose "System", select the tab named "Expanded" or "Extended" (german: "Erweitert") and click the button "environment variables" (german: "Umgebungsvariablen"). In the system variables list double-click "PATH".
Note: Do not remove the existing value!
Before the existing text insert "C:\Program Files\Krause\bin" and a semicolon as separator.
Make sure the first directory listed is "C:\Program Files\Krause\bin".
If there is a reason to use the DLL versions of the libraries append the directory "C:\Program Files\Krause\dll-bin" after the last directory. This is only necessary if you want to use the Perl XS modules using the dklibs library set.
On Windows 9x you have to edit the "\AUTOEXEC.bAT" file. Search for the last line started by 

SET PATH=
and append a further line 
SET PATH=C:\Programme\Krause\bin;%PATH%

Use Windows XP version of kls.exe

If you run the software on a Windows XP system copy kls-xp.exe to kls.exe in C:\Program Files\Krause bin. The XP version supports large files (64 bits are used for file size). The default version kls.exe uses only 32 bits for file sizes.

Correct mkpdfsls.pl script

In the ...\bin\mkpdfsls.pl script search for lines containing ``#####'' and correct the line following this comment.
Make sure to have the correct directory, i.e. ``c:/programme/krause/share/uc2lat-t'' or ``c:/program files/krause/share/uc2lat-t''...

Customize font configuration for fig2vect's SVG output driver

For source type = system fonts make sure to have the fonts available in System control / Fonts. Depending on your Windows version and language you possibly have to change names like 

Times New Roman Fett Kursiv
to 
Times New Roman Bold Italic
For source type = download specify the directory where the font *.svg file is located (either a local directory or a directory on a web server).

Configure access to LPD print servers

To use klpr, klpq, klprm, klpc and snmpyalc you have to configure yanolc.cfg and snmpyalc.cfg in C:\Windows\Yanolc. There are sample files prepared, you can find additional information about yanolc.cfg and snmpyalc.cfg in yanolc.pdf.

Install Java run-time environment

The Tracecc GUI is a Java application and needs a run-time environment (javaw.exe file). I recommend to use the original one from http://java.sun.com.

Initialize Java preferences system

Logged in as Administrator start the Tracecc GUI once. You can exit the application when the status line shows "Ready".
This application uses the Java preferences system, which needs a special registry key. Non-Administrators do not have the permission to create this key, so you must be logged on as Administrator to create the key.

Configuration data is not removed by uninstall

When uninstalling the software the configuration files and configuration registry entries are not removed. The purpose of this decision is to allow users to

without loosing the configuration.
To completely get rid of this package you have to remove the directories (including all contents) and the registry keys (including all subkeys) manually if they exist.

Dirk Krause http://dktools.sourceforge.net 2008/10/11