This library is geared towards being compiled with MINGW, using MSYS and GNU
Make.

It builds OK, but has only been basically tested, under Cygwin.  There is
certainly no reason why it shouldn't work properly under Cygwin though.

Also it uses fairly basic Win32 calls so I imagine it should run on Windows 95
(or at least 98).  It was developed and tested under Windows 2000.


----------------------------------------------------------------------------
I. BUILDING FOR MINGW & CYGWIN
----------------------------------------------------------------------------

To build:

1. 'cd src'.

2. Edit GNUmakefile and edit the following variables as required:

	INSTALLDIR	This is the directory in which the headers and
			library will be installed as $INSTALLDIR/include
			and $INSTALLDIR/lib.  The default is /usr/local, but
			if you're going to use it ouside MSYS/Cygwin set a
			DOS path, but use *forward* slashes.

	CREATECONF	If set to 1 then this creates a w32dlib-config
			shell script.  This is always installed into
			/usr/local/bin (as you have a proper shell to run it in,
			I felt safe assuming you're using either MSYS or
			Cygwin).  If not edit install.sh accordingly.

	DEBUG		Uncomment this line if you want a debug (-g) build
			that also sends some rudementary output to a text file.

3. Type 'make depend' and then 'make'.

4. If OK, 'cd test' and 'make depend' and make' again.  Run w32dtest.exe and
   make sure it looks like it's not going to fall over in a heap.

5. If all OK, 'cd ..' and 'make install'.

6. For documentation, 'cd src' and then 'make doc'.  The documentation
   will be in ./doc/html -- use index.html to start.  Copy these whereever
   you want.  Note that doxygen must be on the path for this to work.

7. Alternatively look at ./src/test/w32dtest.cpp for example code on using
   w32dlib.


----------------------------------------------------------------------------
II. W32DLIB-CONFIG USAGE
----------------------------------------------------------------------------

If you set up the makefile to install w32dlib-config you can use it in
makefiles to aid portability between user's development environments.

usage: w32dlib-config [--libs|--cflags|-archive]

--libs		Provides the necessary -L and -l arguments to use W32DLib.
		Note that -mwindows will also be seperately needed.

		eg.

		% w32dlib-config --libs
		-L/usr/local/lib -lw32dlib -lcomctl32 -lcomdlg32 -lole32

--cflags	Provides the necessary compiler switches to see the include
		files.

		eg.

		% w32dlib-config --cflags
		-I/usr/local/include

--archive	In case you have a need to reference the library archive
		directly, its name can be got with this.

		eg.

		% w32dlib-config --archive
		/usr/local/lib/libw32dlib.a


----------------------------------------------------------------------
$Id: INSTALL,v 1.4 2005-04-24 22:41:34 ianc Exp $