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.


----------------------------------------------------------------------------
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, I
			assume your 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 (I thought I did, but it turned out
		I didn't, but the switch stays) to reference the library archive
		directly, it's name can be got with this.

		eg.

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


----------------------------------------------------------------------
$Id: INSTALL,v 1.3 2005-04-15 23:56:34 ianc Exp $