a0a302dcba
(just so Vadim hates it even more :-)) git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@1084 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
147 lines
5.3 KiB
Plaintext
147 lines
5.3 KiB
Plaintext
|
|
Installing wxWindows 2.0
|
|
------------------------
|
|
|
|
Unarchiving
|
|
-----------
|
|
|
|
If there is a setup program, run the setup program that comes with the Windows version.
|
|
Do not install into a path that contains spaces. The installation program should set the
|
|
WXWIN environment variable, which will be activated when your machine is rebooted.
|
|
|
|
If there is no setup program, it will come as a series of .zip
|
|
files:
|
|
|
|
wx200gen.zip Generic source code and samples (required)
|
|
wx200msw.zip Windows-specific source code and samples (required)
|
|
wx200doc.zip Documentation source code (not required)
|
|
wx200hlp.zip WinHelp documentation
|
|
wx200pdf.zip Acrobat PDF documentation
|
|
wx200htm.zip HTML documentation
|
|
|
|
Unarchive the required files plus any optional documentation
|
|
files into a suitable directory such as c:\wx. Alter your
|
|
WXWIN environment variable to point to this directory.
|
|
|
|
Compilation
|
|
-----------
|
|
|
|
At present, wxWindows compiles with VC++ 4.0/5.0/6.0,
|
|
BC++ 4.5/5.0, Gnu-Win32 b19/b20, and Mingw32. It may compile
|
|
with 16-bit compilers (BC++ and VC++ 1.5) but this hasn't
|
|
been tested lately.
|
|
|
|
Visual C++ 4.0/5.0/6.0 compilation
|
|
----------------------------------
|
|
|
|
1. Change directory to wx\src\msw. Type 'nmake -f makefile.nt' to
|
|
make the wxWindows core library.
|
|
2. Change directory to wx\samples and type 'nmake -f makefile.nt'
|
|
to make all the samples. You can also make them individually.
|
|
|
|
Visual C++ 1.5 compilation
|
|
--------------------------
|
|
|
|
1. Change directory to wx\src\msw. Type 'nmake -f makefile.dos' to
|
|
make the wxWindows core library.
|
|
2. Change directory to wx\samples and type 'nmake -f makefile.dos'
|
|
to make all the samples. You can also make them individually.
|
|
NOTE: only a few samples have up-to-date makefiles, e.g.
|
|
minimal, docview, mdi. The utils makefile does not yet work.
|
|
|
|
Borland C++ 4.5/5.0 compilation
|
|
-------------------------------
|
|
|
|
1. Change directory to wx\src\msw. Type 'make -f makefile.b32' to
|
|
make the wxWindows core library.
|
|
2. Change directory to wx\samples and type 'make -f makefile.b32'
|
|
to make all the samples. You can also make them individually.
|
|
NOTE: only a few samples have up-to-date makefiles, e.g.
|
|
minimal, docview, mdi. The utils makefile does not yet work.
|
|
|
|
Gnu-Win32 b19/b20/Mingw32 compilation
|
|
-------------------------------------
|
|
|
|
wxWindows 2.0 supports Gnu-Win32/Cygwin b19, b20, Mingw32, and Mingw32/EGCS.
|
|
|
|
Thanks are due to Keith Garry Boyce (garp@opustel.com) and Cygnus for making
|
|
it all possible.
|
|
|
|
From wxWindows 2.0 beta 9, both Gnu-Win32 and Mingw32 (the minimal
|
|
distribution of Gnu-Win32) can be used with the same makefiles.
|
|
|
|
Here are the steps required:
|
|
|
|
- Retrieve and install the latest beta of Gnu-Win32, or Mingw32, as per the
|
|
instructions with either of these packages.
|
|
|
|
- If using Mingw32 (including the EGCS variant), you need some
|
|
extra files to use the wxWindows makefiles. You can find these
|
|
files in ports/mingw32 on the ftp site or CD-ROM, as extra.zip.
|
|
These should be extracted to the Mingw32 directory.
|
|
|
|
- Modify the file wx/src/cygnus.bat (or mingw32.bat or mingegcs.bat)
|
|
to set up appropriate variables, if necessary mounting drives.
|
|
Run it before compiling.
|
|
|
|
- For Gnu-Win32, make sure there's a \tmp directory on your
|
|
Windows drive or bison will crash.
|
|
|
|
- Edit wx/src/makeg95.env and search for MINGW32. Take note of
|
|
the comments for adjusting settings to suit Gnu-Win32 or
|
|
Mingw32. Basically, this is just a case of adding the __MINGW32__ symbol
|
|
to OPTIONS for Mingw32, or removing it for Cygnus Gnu-Win32.
|
|
For Mingw32/EGCS, add both __MINGW32__ and __EGCS__.
|
|
|
|
- Mingw32 may not support winsock.h, so comment out
|
|
socket-related files in src/msw/makefile.g95.
|
|
|
|
- Use the makefile.g95 files for compiling wxWindows and samples,
|
|
e.g.:
|
|
> cd c:\wx\src\msw
|
|
> make -f makefile.g95
|
|
> cd c:\wx\samples\minimal
|
|
> make -f makefile.g95
|
|
|
|
- Use the 'strip' command to reduce executable size.
|
|
|
|
- With Cygnus Gnu-Win32, you can invoke gdb --nw myfile.exe to
|
|
debug an executable. If there are memory leaks, they will be
|
|
flagged when the program quits.
|
|
|
|
- If using GnuWin32 b18, you will need to copy windres.exe
|
|
from e.g. the Mingw32 distribution, to a directory in your path.
|
|
|
|
All targets have 'clean' targets to allow removal of object files
|
|
and other intermediate compiler files.
|
|
|
|
Gotchas:
|
|
|
|
- libwx.a is 48 MB or more - but much less if compiled with no
|
|
debug info (-g0) and level 4 optimization (-O4).
|
|
- install.exe doesn't have built-in decompression because lzexpand.lib
|
|
isn't available with Gnu-Win32. However, you can use it with external
|
|
decompression utilities.
|
|
- Doesn't compile src/msw/ole files, so no drag and drop.
|
|
|
|
References:
|
|
|
|
- The GNU-WIN32 site is at
|
|
http://www.cygnus.com/gnu-win32/
|
|
- Mingw32 is available at:
|
|
http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/index.html
|
|
- See also http://web.ukonline.co.uk/julian.smart/wxwin/gnuwin32.htm
|
|
|
|
Notes
|
|
-----
|
|
|
|
- Debugging: under Windows 95, debugging output isn't output in
|
|
the same way that it is under NT or Windows 3.1. Set
|
|
wxUSE_DBWIN32 to 1 if you wish to enable code to output debugging
|
|
info to an external debug monitor, such as Andrew Tucker's DBWIN32.
|
|
You can download DBWIN32 from:
|
|
|
|
http://ftp.digital.com/pub/micro/NT/WinSite/programr/dbwin32.zip
|
|
|
|
and it's also on the wxWindows CD-ROM.
|