DK Tools and Libaries
=====================
This package contains Dirk Krause's tools and libraries.
SourceForge project page:	http://sourceforge.net/projects/dktools
Project home page:		http://sourceforge.net/p/dktools/wiki/Home/

License
=======
The software is licensed to you under the terms of a BSD style license,
see LICENSE.

The live systems produced by the scripts/debian-build-live
script are licensed under the same license conditions as Debian GNU/Linux
itself (the live systems are derived from Debian).

Installation
============
See the INSTALL file for installation instructions.

Programs
========

Drawing
-------
wxdkdraw         Minimalistic drawing program for use with LaTeX
wxd2lat          Convert wxdkdraw files to PS(+TeX), PDF(+TeX), PGF

Graphics conversion
-------------------
bmpp             Convert PNG, JPEG, TIFF to PDF, PS, EPS
fig2lat          Convrt *.fig to PS(+TeX), PDF(+TeX), PGF
wximgsz          Suggest size pairs to rescale bitmap images

Web publishing
--------------
htmlbook         Publish HTML like a book

Software development
--------------------
dkct             C preprocessor for debugging, tracing, state machines wx GUI
dkwxwiz          Create initial files for wxWidgets + DK tools programs
wxdkhtb          View HTB help files

IT administration
-----------------
itadmin          Create configuration and docu (*.tex) files from MySQL DB

File and directory tols
-----------------------
dk-ls            List files, output column order is configurable
dk-fic           Check file integrity
dk-bmm           Backup media managements
dk-blks          Create stream with constant block size for use with dd
dk-eradisk       Create data stream to erase a disk
dk-hex           Show file contents in hexadecimal or octal notation
dk-pwd           Clone of the pwd program, intended for Windows

Text tools
----------
dk-t2l           Convert plain text to LaTeX
dk-t2h           Convert plain text to HTML
dk-cat           Show file contents, some recoding possible
dk-sort          Sort text line by line

User and password tools
-----------------------
dk-uid           Find free user ID in a given range
dk-pwgen         Create passwords, PIN number or hexadecimal keys
dk-rand          Create binary random data

Network tools
-------------
dk-send          Send data stream to one or multiple recipients running dk-recv
dk-recv          Receive data stream from a dk-send process
rshdown          Fast remote shutdown via specific UDP packet

Windows tools
-------------
dkwt / dkwtadm   List users, groups, printers; keep classroom PCs clean
winprint         Schedule file to Windows print queue
ChangeScreenSize Switch between different screen sizes
wprclean         Remove a users print jobs from local Windows print queues
lprngcl          Remove a users print jobs from LPRng print queues

Printer administration
----------------------
prmonsnmp        Monitor a printer using the SNMP protocol
pjsnmp           LPRng filter to send print job to networked printer
printqd          Daemon to enforce print quota on LPRng print systems
printqdc         Client program to query printqd
wxpqdic          GUI client program to query printqd, show users print limit
addctrld         Ensure final CTRL-d at end of data stream

Simple databases tools
----------------------
dk-t2db          Create simple text data base from plain text
dk-db2t          Convert simple text data base to text
dk-dbco          Copy simple databases

Database tools
--------------
dk-sqlsplit      Split overlong SQL lines as produced by mysqldump

Other programs
--------------
plpdftex         Output driver for octpgfpl to produce PDF+TeX
wxdkclock        Simple clock with one alert

PROBLEMS IN THIS SOURCE PACKAGE REPORTED BY LINTIAN

Error: source-contains-prebuilt-ms-help-file
--------------------------------------------
The lintian program, when run on the *.dsc source package, writes
error messages for existing *.chm help files in the source archive.
The https://lintian.debian.org/tags/source-contains-prebuilt-ms-help-file.html
web site states: "Whilst there is free software to read and write them, any
examples existing in source packages are likely to be created by the
proprietary Microsoft software and are probably missing the source HTML and
associated files.".

The source archive dktools-x.y.z.tar.gz allows to build executables
for a variety of platforms, including Windows. The source archive includes
*.chm files for use on Windows including all sources used to build them.
On Linux there is the chmcmd program from Free Pascal (fp-utils-3.0.4 package)
to build CHM files.  Windows users could use the more than 10 years
old HTML workshop, but most of them have never heard about it.
So I provide the CHM files ready to use in addition to the sources.

My opinion: A package checker program,
- claiming to inspect software packages for problems, and
- used to automatically reject software projects from being used in a
  Linux distribution
should not damn projects based on
- just the existance of help files for another platform, and
- "are likely" and "are probably" assumptions.

Warning: maintainer-script-empty
--------------------------------
This warning is reported for the rshdown and printqd packages.
Both packages contain services, on Debian Buster started by SystemD.
If I understood the documentation correctly, using the template
containing the "#DEBHELPER#" line is sufficient. This line is automatically
replaced by code to install and enable or disable and uninstall the service.
So there is an advice to use the template "as is" and a lintian warning
about exactly doing that.

Please use the dktools-4.31.1.zip archive to build for Windows!
------------------------------------------------------------------
The *.chm help files for Windows are not included in the *.tar.gz archive,
the config/windows directory is missing too.

Looks like this directory was extracted from the *.tar.gz archive.

The packaging guidelines of some Linux distributions (i.e. Debian)
do not allow pre-compiled CHM help files in the upstreams original
source archive, even if these CHM files are not used at all on
non-Windows systems, even if all sources to build the CHM files
are included, and the free software chmcmd from the fp-utils
(Free Pascal) package is used to create the CHM.
Checker programs (i.e. lintian) produce an error, this results in
automatically rejecting the package. See
https://lintian.debian.org/tags/source-contains-prebuilt-ms-help-file.html
for details.

So the situation is uncomfortable: We can not use the same source archive
to build Windows executables and binary packages for these Linux distributions.