	    WkLib - A Multi Platform Development Environment
			Version 2.16
		Werner Koch <werner.koch@guug.de>

Supported platforms:
---------------------
WkLib supports these platforms:
 - Linux
 - HP-UX  (system compiler or gcc)
 - OS/2   (with EMX or Watcom compiler)

Cross platform development from a Linux host can be done for:
 - Windows95,WinNT  using the Mingw32/CPD Package

Cross platform development from a OS/2 host can be done for:
 - MSDOS     using the Watcom compiler
 - Windoze   using the Watcom compiler
 - Netware   using the Watcom compiler

There is some support for other compilers which I used in the past, but I
do not support them anymore.


How to Install:
---------------

1) Do a "make" -- this is all. There is no need for a "make install".

2) To use the library you should set the environment variable
   WKLIBS to the top directory, where this packages is installed.
   e.g. if you installed it under:
	/home/karl/wklib-2.16
   you should set
       WKLIBS=/home/karl/wklib-2.16

3) You need the tool "ldsh" in your path:
   - Copy or link "tools/ldsh" to /usr/local/bin/ldsh.
   - Copy or link "tools/ldsh.cfg " to /usr/local/lib/ldsh.cfg.
   "ldsh" is a linker front end with some nice features. It's main purpose
   is to make the writing of Makefiles for MSDOS and Unix platforms easier.
   It is a great help to create DLLs for Win32 because it knows how to run
   ld and dlltool to make relocatable DLLs. It has a feature to create
   an object file on the fly with such info as the time of the link run,
   which can be used to give information on the exact version of a program
   (try "ldsh --version" to see what I mean).


Why the weird directory structure:
----------------------------------
This layout of the directories is used to keep object files and binaries
online as long as possible. I use a file server (Linux box with Samba) for
my development. If I have to create Msdos,Netware etc. applications, I switch
my monitor and keyboard to an OS/2 box, mount the development tree there, hit
"make" and the build is done. When I have to create binaries for another
platform, I can do so without disturbing the build process on the OS/2 host.
Creating distributions, editing, etc is always done on a Linux box.

Another reason for multiple directories is to keep debug and production
separate. Debug versions are compiled with support for malloc debugging and
stored in directories ending with "-d".

    [FIXME: needs more documentation]


Examples:
---------
See "tools/src" for some examples.


Bugs:
-----
This is the first public distribution, so the installation process will
have some bugs.

Send bug reports or questions regarding this piece of software to

    wk-wklib@isil.d.shuttle.de


Copyright information:
----------------------
    Copyright (c) 1988-97 by Werner Koch (dd9jn)

WkLib is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

WkLib is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You find a copy of the GNU General Public License in wklib/COPYING.

WkLib uses a *modified* version of Henry Spencer's regular expression
module which is
	Copyright (c) 1986 by University of Toronto.
	Written by Henry Spencer.  Not derived from licensed software.
and freely redistributable; see wklib/regexp.c for details.

--
