Update Cygwin/MinGW build instructions.

Remove very out of date information, mention MinGW-w64 and extend Cygwin
explanations.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@75021 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/msw/install.txt

@@ -374,38 +374,35 @@ Note (4): wxUSE_STD_STRING is disabled in wx/string.h for Watcom as this
 Cygwin/MinGW Compilation
 ----------------------------------------------------------------
 
-wxWidgets supports Cygwin (formerly GnuWin32) betas and
+wxWidgets supports Cygwin, MinGW and MinGW-w64 tool chains under Windows.
-releases, and MinGW. Cygwin can be downloaded from:
+They can be downloaded from:
-
-    http://sources.redhat.com/cygwin/
-
-and MinGW from:
 
+    http://www.cygwin.com/
     http://www.mingw.org/
+    http://mingw-w64.sourceforge.net/
 
-Both Cygwin and MinGW can be used with configure (assuming you have MSYS
+respectively. Please retrieve and install the latest version of your preferred
-installed in case of MinGW). You will need new enough MinGW version, preferably
+tool chain by following the instructions provided by these packages. Notice
-MinGW 3.4.2+ (ships with gcc3).
+that Cygwin includes both native Cygwin compiler, which produces binaries that
+require Cygwin during run-time, and MinGW[-w64] cross-compilers which can still
+be used in Cygwin environment themselves but produce plain Windows binaries
+without any special run-time requirements. You will probably want to use the
+latter for developing your applications.
 
-NOTE: some notes specific to old Cygwin (< 1.1.x) are at the end of this
+If using MinGW, you can download the add-on MSYS package to provide Unix-like
-      section (see OLD VERSIONS)
+tools that you'll need to build wxWidgets using configure.
 
-There are two methods of compiling wxWidgets, by using the
+All of these tool chains can be used either with Unix-like configure+make build
-makefiles provided or by using 'configure'.
+process (preferred) or with the provided makefile.gcc makefiles without using
-
+configure:
-Retrieve and install the latest version of Cygwin, or MinGW, as per
-the instructions with either of these packages.
-
-If using MinGW, you can download the add-on MSYS package to
-provide Unix-like tools that you'll need to build wxWidgets using configure.
 
 Using makefiles Directly
 ----------------------------------------------------------------
 
 NOTE: The makefile.gcc makefiles are for compilation under MinGW using
-      Windows command interpreter (command.com/cmd.exe), they won't work in
+      Windows command interpreter (command.com/cmd.exe), they won't work
-      other environments (such as UNIX or Unix-like, e.g. MSYS where you have
+      if you use Unix shell, as is the case with MSYS. Follow the instructions
-      to use configure instead, see the section below)
+      for using configure below instead in this case.
 
 Use the makefile.gcc files for compiling wxWidgets and samples,
 e.g. to compile a debugging version of wxWidgets:
@@ -437,81 +434,16 @@ make a build directory, and run configure and make in this directory.
 
 For example:
 
-  cd $WXWIN
+  $ cd $WXWIN
-  mkdir build-debug
+  $ mkdir build-debug
-  cd build-debug
+  $ cd build-debug
-  ../configure --with-msw --enable-debug --enable-debug_gdb --disable-shared
+  $ # Optionally use --disable-shared for static linking
-  make
+  $ ../configure --enable-debug
-  make install % This step is optional, see note (6) below.
+  $ make
-  cd samples/minimal
+  $ make install # This step is optional
-  make
+  $ cd samples/minimal
-  ./minimal.exe
+  $ make
-
+  $ ./minimal.exe
-Notes:
-
-1. See also the Cygwin/MinGW on the web site or CD-ROM for
-   further information about using wxWidgets with these compilers.
-
-2. libwx.a is 100 MB or more - but much less if compiled with no
-   debug info (-g0) and level 4 optimization (-O4).
-
-3. There's a bug in MinGW headers for some early distributions.
-
-   in include/windows32/defines.h, where it says:
-
-   #define LPSTR_TEXTCALLBACKA (LPSTR)-1L)
-
-   it should say:
-
-   #define LPSTR_TEXTCALLBACKA ((LPSTR)-1L)
-
-   (a missing bracket).
-
-4. OpenGL support should work with MinGW as-is. However,
-   if you wish to generate import libraries appropriate either for
-   the MS OpenGL libraries or the SGI OpenGL libraries, go to
-   include/wx/msw/gl and use:
-
-     dlltool -k -d opengl.def -llibopengl.a
-
-   for the SGI DLLs, or
-
-     dlltool -k -d opengl32.def -llibopengl32.a
-
-   and similarly for glu[32].def.
-
-5. The 'make install' step is optional, and copies files
-   as follows:
-
-   /usr/local/lib - wxmswXYZd.dll.a and wxmswXYZd.dll
-   /usr/local/include/wx - wxWidgets header files
-   /usr/local/bin - wx-config
-
-   You may need to do this if using wx-config with the
-   default root path.
-
-6. With Cygwin, you can invoke gdb --nw myfile.exe to
-   debug an executable. If there are memory leaks, they will be
-   flagged when the program quits. You can use Cygwin gdb
-   to debug MinGW executables.
-
-7. Note that gcc's precompiled headers do not work on current versions of
-   Cygwin. If your version of Cygwin is affected you will need to use the
-   --disable-precomp-headers configure option.
-
-OLD VERSIONS:
-
-- 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 Cygwin, make sure there's a \tmp directory on your
-  Windows drive or bison will crash (actually you don't need
-  bison for ordinary wxWidgets compilation: a pre-generated .c file is
-  supplied).
-
-- If using GnuWin32 b18, you will need to copy windres.exe
-  from e.g. the MinGW distribution, to a directory in your path.
 
 
 DigitalMars C++ Compilation