--------------------------------------
Installation of wxWindows Version 1.50
--------------------------------------

---------
File List
---------

In wxwin150.tar.Z and wxwin150.zip:

contrib/*			User contributions

docs/classes.tex                Part of LaTeX manual
docs/help.xlp			Introduction to wxHelp in wxHelp format
docs/hytext.xlp			hyText class reference in wxHelp format
docs/files.txt			Full file list
docs/install.txt		This file
docs/manual.tex                 LaTeX user manual source
docs/manual.ps                  PostScript user manual manual
docs/referenc.tex               LaTeX reference manual source
docs/referenc.ps                PostScript reference manual
docs/readme.txt			Describes wxWindows briefly
docs/wx.xlp			wxWindows class reference in wxHelp format

include/base/*.h                Base header files (wx.h is main include file)
include/x/*.h                   X header files
include/msw/*.h                 Windows header files
include/msw/wx.rc               Resource file (required for all Win 3 apps)
include/msw/*.cur               Windows 3 cursors

lib/wx.lib                      wxWindows library (Windows 3, large model)
lib/libwx_ol.a                  wxWindows library (XView)
lib/libwx_motif.a               wxWindows library (XView)
				(THESE FILES CREATED ON INSTALLATION)

src/base/*.cc                   Base source files
src/base/makefile.unx           UNIX base makefile
src/base/makefile.dos           DOS makefile
src/x/*.cc                      X source files
src/x/makefile.unx              UNIX makefile
src/x/sb_scrol.c		XView patch (see below)
src/msw/*.cc                    Windows source files
src/msw/makefile.dos            DOS makefile

samples/form                    Form demo directory
samples/hello                   Hello demo directory
samples/ipc                     Interprocess comms demo directory
samples/mdi                     Multiple Document Interface demo directory
samples/minimal                 Minimal app demo directory

utils/hytext                    Hypertext library
utils/hytext/docs               Hypertext library documentation
utils/hytext/src                Hypertext library source

utils/wxhelp                    wxHelp help system
utils/wxhelp/docs               wxHelp documentation
utils/wxhelp/src                wxHelp source (requires hytext library)

utils/prologio                  PROLOGIO file format utility
utils/prologio/docs             Documentation
utils/prologio/src              Source

utils/toolbar                   wxToolBar utility
utils/toolbar/docs              Documentation
utils/toolbar/src               Source

utils/wxclips                   Interface to NASA's CLIPS
utils/wxclips/docs              Documentation
utils/wxclips/src               Source

Executables are suffixed with -ol for Open Look and -motif for Motif.

The executable UNIX demos are in demo-ol.tar.Z and demo-motif.tar.Z
and the PC demo is in demo.zip, along with the demo sources.

----------------
Installation: PC
----------------

1) Unzip to an appropriate place on your hard disk with 'unzip -d wxwin150.zip'.
2) If you have the demo executable (in demo.zip), unzip it and
   install it in the Program  Manager by dragging the HELLO.EXE file from the
   File Manager.
3) Run demo to check if wxWindows might be for you.
   If not, delete wxWindows. If you're still with us at this point...
4) Set the WXHELPFILES variable to point to the docs directory, and WX to point to the
   directory where wxWindows is installed.
5) If using Microsoft C++, change to the src/msw directory and type 'nmake -f makefile.dos'
   to make lib/wx.lib. No Borland project files are included yet.
6) Print manual.ps and referenc.ps on a PostScript printer. The reference manual is just
   over 100 pages, the user manual is shorter.

If you wish to use the wxHelp hypertext help system, either for
your own applications or for viewing the wxWindows class library reference,
you will need to do download the binary (in wxhelp14.zip) or make
wxHelp as follows:

7) Edit the makefile in utils/hytext/src and compile the library.
8) Edit the makefile in utils/wxhelp/src and compile wxhelp.exe.
9) Copy wxhelp.exe into a directory on your path, and read the
   wxHelp documentation.

By default, wxWindows is compiled with CodeView debugging information.
To compile without debugging information, specify FINAL=1 on your make
command line. Note that to produce a non-debugging executable you need
only relink your application (or the demo) since any debugging
information in the wxWindows library will be removed by the linker if
the FINAL flag is set to 1.

------------------
Installation: UNIX
------------------

1) Uncompress wxWindows with 'uncompress wxwin150.tar.Z' and untar with
   'tar -xvf wxwin150.tar'.
2) If you have the demo executable (in demo-ol.tar.Z or demo-motif.tar.Z),
   uncompress, untar and try running it. You'll need the run-time libraries
   appropriate to the toolkit (XView 3.1 or Motif 1.1).
3) If you want to use XView and XView 3.1 is not present, install it (it's
   available free on the Net). Your LD_LIBRARY_PATH may need to be altered
   or disabled.
4) If GCC/G++ is not installed, install it (again, available free). Or you
   could try an alternative compiler (AT&T C++ is known to work with wxWindows).
5) Alter src/x/makefile.unx and src/base/makefile.unx to reflect your
   directory structure.
6) Change directory to src/x, and type 'make -f makefile.unx xview' or
   'make -f makefile.unx motif'. With luck, libwx_ol.a or libwx_motif.a
   should end up in the lib directory.
7) Set the WXHELPFILES environment variable to point to the docs directory.
8) Edit the demo makefiles and compile (especially the main `hello' example).
   Again, specify 'xview' or 'motif' as target.

If you wish to use the wxHelp hypertext help system, either for
your own applications or for viewing the wxWindows class library reference,
you will need to do download the binaries (in wxhelp14.tar.Z) or make
wxHelp as follows:

9)  Edit the makefile in utils/hytext/src and compile the library.
10) Edit the makefile in utils/wxhelp/src and compile wxhelp.exe.
11) Copy wxhelp into a directory on your path, and read the
    wxHelp documentation.

If you are likely to be using XView and modal windows, where the flow
of the program is stopped until the user responds, you will need to
link sb_scrol.o with your application. This is an XView patch which
(sort of) fixes listboxes on modal dialogs (i.e. on a window within
xv_window_loop). Listboxes don't scroll without the patch. Other
widgets may be affected by this bug. The object file sb_scrol.o is
supplied for SPARC-based machines; you will need to compile sb_scrol.c
otherwise (type 'make -f makefile.unx objects_ol/sb_scrol.o' in src/x).

By default, wxWindows is compiled with debugging information.  To
compile without debugging information, specify DEBUG= on your make
command line. Note that under UNIX you need to do this for both the
wxWindows library and your application, to remove all debugging
information.

You may find the scripts wxcopy (UNIX) and wxcopy.bat (4DOS)
useful for copying wxWindows between different machines or directories.

------------------------
Notes for AT&T C++ users
------------------------

The following changes need to be made for this compiler:

-- in wx_dc.cc, this should be added near the top: #include <sysent.h>
-- an updated version of varargs.h should be used for older versions of the
   compiler.
-- Ignore warnings about wxList::Member and wxStringList::Member in wx_list.cc

-------------------------------------------------------
Known platforms and compilers compatible with wxWindows
-------------------------------------------------------

(please let me know of any others!)

PC 386SX and above
Sun (SPARC)
Linux

Gnu GCC 2.1
AT&T C++
Sun C++
Microsoft C/C++ 7
Borland C++ 3.1
Zortech C++