diff --git a/Doc/Manual/Windows.html b/Doc/Manual/Windows.html index 8bee04ae9..a6e0d7473 100644 --- a/Doc/Manual/Windows.html +++ b/Doc/Manual/Windows.html @@ -29,17 +29,16 @@
  • Instructions for using the Examples with other compilers -
  • SWIG on Cygwin and MinGW -
  • Microsoft extensions and other Windows quirks @@ -210,28 +209,26 @@ RUBY_LIB: D:\ruby\lib\mswin32-ruby16.lib
    If you do not have access to Visual C++ you will have to set up project files / Makefiles for your chosen compiler. There is a section in each of the language modules detailing what needs setting up using Visual C++ which may be of some guidance. Alternatively you may want to use Cygwin as described in the following section.

    -

    3.3 SWIG on Cygwin and MinGW

    +

    3.3 Building swig.exe on Windows

    -SWIG can also be compiled and run using Cygwin or MinGW which provides a Unix like front end to Windows and comes free with gcc, an ISO C/C++ compiler. However, this is not a recommended approach as the prebuilt executable is supplied. +The SWIG distribution provides a pre-built swig.exe and so it is not necessary for users to build the SWIG executable. +However, this section is provided for those that want to modify the SWIG source code in a Windows environment. +Normally this is not needed, so most people will want to ignore this section.

    -

    3.3.1 Building swig.exe on Windows

    - -

    -If you want to replicate the build of swig.exe that comes with the download, follow the MinGW instructions below. -This is not necessary to use the supplied swig.exe. -This information is provided for those that want to modify the SWIG source code in a Windows environment. -Normally this is not needed, so most people will want to ignore this section. +There are various ways to build the SWIG executable including CMake which is able to generate project files for building with Visual Studio. +SWIG can also be compiled and run using MSYS2, Cygwin or MinGW, all of which provide a Unix like front end to Windows and comes free with the gcc C/C++ compiler.

    -

    3.3.1.1 Building swig.exe using CMake

    + +

    3.3.1 Building swig.exe using CMake

    -SWIG can also be built using CMake and Visual Studio rather than autotools. As with the other approaches to +SWIG can be built using CMake and Visual Studio rather than autotools. As with the other approaches to building SWIG the dependencies need to be installed. The steps below are one of a number of ways of installing the dependencies without requiring Cygwin or MinGW. For fully working build steps always check the Continuous Integration setups currently detailed in the Appveyor YAML file.

    @@ -304,7 +301,7 @@ swig.exe -help
    -python -c++ -o C:\Temp\doxygen_parsing.cpp C:\swig\Examples\test-suite\doxygen_parsing.i
    -

    3.3.1.2 Building swig.exe using MSYS2

    +

    3.3.2 Building swig.exe using MSYS2

    @@ -356,7 +353,7 @@ make install -

    3.3.1.3 Building swig.exe using MinGW and MSYS

    +

    3.3.3 Building swig.exe using MinGW and MSYS

    @@ -474,7 +471,7 @@ make -

    3.3.1.4 Building swig.exe using Cygwin

    +

    3.3.4 Building swig.exe using Cygwin

    @@ -486,7 +483,7 @@ These files are generated using the autogen.sh script and will only nee

    -

    3.3.2 Running the examples on Windows using Cygwin

    +

    3.3.4.1 Running the examples on Windows using Cygwin