wxqt2s ALPHA

(c) Jonathan Hudson 1999-2000. See the file COPYING for licence.

wxqt2 requires qltools v2.13 or later and qxltool 1.13 or later; both
these programs may be obtained from http://www.bigfoot.com/~jrhudson/

To build the software from source, install the archive and type
'make'. It's that simple :-).

For the benefit of Windows lusers, a Windows binary (and DLL)
available from the same site. 

For Unix, it is assumed that the user is somewhat more competent and
is able to follow hyperlinks to download the necessary components and
is capable of typing simple commands like 'tar', 'configure' and
'make'.

In order to build wxqt2, you need:

g++ (2.91 or later, 2.95 recommended), Mingw for Windows
 or Borland C++ for Windows     
wxWindows 2.1 (beta 15 or later)
On Unix, a supported X library (Xt, Motif or GTK+)

In order to use the help menu option, it is necessary to set the
environment variable WXQT2_HELP_DIR to indicate the directory in which
the help files are stored (i.e. the _entire_ contents of the doc/
directory from the distribution archive.  The following examples
assume you've installed contents of the 'doc' directory:

Unix

export WXQT2_HELP_DIR=/opt/doc/wxqt2/

or add a [Help] Dir = entry in ~/.wxqt2, for example:

 [Help]
 Dir=/opt/doc/wxqt2


Windows/cygwin

export WXQT2_HELP_DIR=C:/wxqt2/doc or add a registry entry as below:

Windows/DOS

Try set /? then work it out yourself, if you can.

Alternatively, have a look a qltapp.cc and the contents of the
Registry. and work it out yourself.

The key (modulo Win32 version) is
HKEY_USERS\luser\Software\dld.org\wxqt2\Help\Dir, where luser is the
user name. 

If you don't understand this, I'm not going to further help you break
your Registry.

If is unlikely that this software supports the Win2000/NTFS5. It will
run on Win2000, it just does not know how to access the (new) file
system. Standard NTFS or vFAT is OK. This is a (Microsoft brain dead)
feature. You could try rebuilding it with BC++ or VC++; it may work
(or NoT).


INSTALLATION
============

Unpack the archive into a temporary directory. 
  
On Unix:

	unzip -d /tmp/ wxqt2.zip
	cd wxqt2
	make
	cp Unix/wxqt2 /usr/local/bin # or wherever
	mkdir /opt/doc/wxqt2
	cp -a docs /opt/doc/wxqt2
	set WXQT2_HELP_DIR as required
	Obtain qxltool and qltools, unpack and install.

Windows:
	a) Using InfoZip
	unzip -d /tmp/ wxqt2.zip
	copy the docs directory to somewhere convenient

	b) Uncompress the DLLs. In the unlikely event of you not having
	a bzip2/bunzip2 binary, you can find it at
	http://www.muraroa.demon.co.uk/

	bzip2 -d wx22_0.dll.bz2
	bzip2 -d wxqt2.exe.bz2

	Copy wx22_0.dll and wxqt2.exe to a directory on your path.

	Copy the documentation somewhere convenient
	set WXQT2_HELP_DIR (or the registry) as required	
	Obtain qxltool and qltools, unpack and install.

jrhudson@bigfoot.com						06/11/99

v0.03	28/01/00	Removed try/catch exceptions, as Windows
			may core dump on an exception. Sad.

v0.04   13/02/00	Enabled compilation with Borland C++

v0.05   20/02/00	Fixed read/write QXL to Windows root directory
			(Thanks to Dilwyn Jones for help in tracking
			down this bug).  

v0.06   04/03/00	Fixed a unitialised variable that became
			apparent when using some non-default GNOME
			themes.

v0.07   16/03/00	?

v0.08	05/04/00	Incorporated help and windows DLL

v0.09   15/10/00	Work on Unix read-only media

