__MWERKS__ check now doesn't give compilation error with VC++

[wxWidgets.git] / docs / msw / install.txt

diff --git a/docs/msw/install.txt b/docs/msw/install.txt
index ddedd6764dce5a07c05efc602c61d09eb5407fba..bae42ad73f9c580360d644328a7afbba55d93b72 100644 (file)
--- a/docs/msw/install.txt
+++ b/docs/msw/install.txt
@@ -16,10 +16,9 @@ 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
 wx200msw.zip            Windows-specific source code and samples (required)
 wx200doc.zip            Documentation source code (not required)
 wx200hlp.zip            WinHelp documentation

-wx200ps.zip             PostScript documentation (will probably
-                        disappear in favour of PDF)

 wx200pdf.zip            Acrobat PDF documentation
 wx200htm.zip            HTML documentation
 wx200pdf.zip            Acrobat PDF documentation
 wx200htm.zip            HTML documentation

+wx200vc.zip             MS VC++ 5.0 project files

 
 Unarchive the required files plus any optional documentation
 files into a suitable directory such as c:\wx. Alter your
 
 Unarchive the required files plus any optional documentation
 files into a suitable directory such as c:\wx. Alter your


@@ -28,11 +27,26 @@ WXWIN environment variable to point to this directory.
 Compilation
 -----------
 
 Compilation
 -----------
 

-At present, wxWindows compiles with VC++ 1.5, VC++ 4.0, VC++ 5.0,
-BC++ 4.5/5.0, Gnu-Win32 b19, and Mingw32.
+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 compilation
-------------------------------
+Visual C++ 4.0/5.0/6.0 compilation
+----------------------------------
+
+Using project files:
+
+1. Unarchive wx200vc.zip, the VC++ 5 project makefiles.
+2. Open src/wxvc.dsp, set Debug or Release configuration, and
+   compile. This will produce lib/wxvc.lib or lib/wxvc_debug.lib.
+3. Open a sample project file, choose a configuration, and compile.
+   Currently only the minimal and mdi samples have project files.
+   To create others, copy the .dsp/.dsw files from the minimal
+   sample and globally replace 'MinimalVC' and 'minimal' with
+   suitable names. Add any other required source files.
+
+Using makefiles:

 
 1. Change directory to wx\src\msw. Type 'nmake -f makefile.nt' to
    make the wxWindows core library.
 
 1. Change directory to wx\src\msw. Type 'nmake -f makefile.nt' to
    make the wxWindows core library.


@@ -44,7 +58,7 @@ Visual C++ 1.5 compilation
 
 1. Change directory to wx\src\msw. Type 'nmake -f makefile.dos' to
    make the wxWindows core library.
 
 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.b32'
+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.
    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.


@@ -59,15 +73,15 @@ Borland C++ 4.5/5.0 compilation
    NOTE: only a few samples have up-to-date makefiles, e.g.
    minimal, docview, mdi. The utils makefile does not yet work.
 
    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/Mingw32 compilation
----------------------------------
+Gnu-Win32 b19/b20/Mingw32 compilation
+-------------------------------------

 
 

-wxWindows 2.0 supports Gnu-Win32 b19, Mingw32, and Mingw32/EGCS.
+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.
 
 
 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 b19 and Mingw32 (the minimal
+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:
 distribution of Gnu-Win32) can be used with the same makefiles.
 
 Here are the steps required:


@@ -79,6 +93,8 @@ Here are the steps required:
   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.
   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.

+  IMPORTANT: also see mingw32.txt in this directory (docs/msw)
+  about a fix that has to be applied to a Mingw32 header file.

 
 - Modify the file wx/src/cygnus.bat (or mingw32.bat or mingegcs.bat)
   to set up appropriate variables, if necessary mounting drives.
 
 - Modify the file wx/src/cygnus.bat (or mingw32.bat or mingegcs.bat)
   to set up appropriate variables, if necessary mounting drives.


@@ -93,6 +109,9 @@ Here are the steps required:
   to OPTIONS for Mingw32, or removing it for Cygnus Gnu-Win32.
   For Mingw32/EGCS, add both __MINGW32__ and __EGCS__.
 
   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
 - Use the makefile.g95 files for compiling wxWindows and samples,
   e.g.:
   > cd c:\wx\src\msw


@@ -103,7 +122,8 @@ Here are the steps required:
 - Use the 'strip' command to reduce executable size.
 
 - With Cygnus Gnu-Win32, you can invoke gdb --nw myfile.exe to
 - Use the 'strip' command to reduce executable size.
 
 - With Cygnus Gnu-Win32, you can invoke gdb --nw myfile.exe to

-  debug an executable.
+  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.
 
 - If using GnuWin32 b18, you will need to copy windres.exe
   from e.g. the Mingw32 distribution, to a directory in your path.


@@ -113,10 +133,12 @@ and other intermediate compiler files.
 
 Gotchas:
 
 
 Gotchas:
 

-- libwx.a is 28 MB or more.
+- 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.
 - 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:
 
 
 References:
 


@@ -126,3 +148,15 @@ References:
      http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/index.html
  - See also http://web.ukonline.co.uk/julian.smart/wxwin/gnuwin32.htm
 
      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 under Packages.