# 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 (BSD-style license, see below).
- License terms for the used libraries (see below).

### 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:

- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the Dirk Krause nor the names of other contributors may be used to endorse or promote products derived from this software without specific prior written permission.

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:

- zlib

  Homepage / Download: | http://www.gzip.org/zlib
  License terms: | siehe http://www.gzip.org/zlib/zlib_license.html

- libbz2

  Homepage / Download: | http://sources.redhat.com/bzip2
  License terms: | BSD-style license, see the file LICENSE in the bzip2 souce code package

The programs bmeps.exe and fig2vect.exe and the libraries bmeps.lib, bmeps.dll, dkbif.lib and dkbif.dll use the following additional libraries:

- libpng

  Homepage / Download: | http://www.libpng.org/pub/libpng.html
  License terms: | see the LICENSE file in the libpng source code package

- jpeglib

  Homepage / Download: | http://www.ijg.org
  License terms: | see the LICENSE file in the jpegsrc source code package

- NetPBM

  Homepage / Download: | http://netpbm.sourceforge.net
  License terms: | see the documentation in the NetPBM source code package

- libtiff

  Homepage / Download: | http://www.libtiff.org
  License terms: | see the documentation in the libtiff source code package

The programs kls.exe, kls-xp.exe and snmpyalc.exe use the following additional library:

- OpenSSL

  Homepage / Download: | http://www.openssl.org
  License terms: | Apache-style license, see the documentation in the OpenSSL source code package. These license terms also apply to the openssl.exe program and the *eay32.lib- and *eay32.dll libraries.

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:

- NetSNMP

  Homepage / Download: | http://net-snmp.sourceforge.net
  License terms: | BSD-style license, see the COPYING.txt file in the NetSNMP source code package. These license terms also apply to the snmp*.exe and encode_keychange.exe program and the snmp*.lib and snmp*.dll libraries.

## 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

- either uninstall the software and re-install it on another hard disk drive
- or uninstall the user edition and install the developer edition

without loosing the configuration.
To completely get rid of this package you have to remove the directories (including all contents)

- C:\Windows\Fig2vect
- C:\Windows\Yanolc

and the registry keys (including all subkeys)

- HKEY_LOCAL_MACHINE\Software\DkApp
- HKEY_LOCAL_MACHINE\Software\DKrause\Shared\Yalc
- HKEY_LOCAL_MACHINE\Software\DKrause\Shared\Yanolc
- HKEY_LOCAL_MACHINE\Software\DKrause\Yalc
- HKEY_CURRENT_USER\Software\DkApp
- HKEY_CURRENT_USER\Software\DKrause\Shared\Yalc
- HKEY_CURRENT_USER\Software\DKrause\Shared\Yanolc
- HKEY_CURRENT_USER\Software\DKrause\Yalc

manually if they exist.