diff --git a/docs/msw/install.txt b/docs/msw/install.txt
index d2b0e411f4..fb683471ae 100644
--- a/docs/msw/install.txt
+++ b/docs/msw/install.txt
@@ -46,7 +46,18 @@ this environment variable is used in the examples below.
NB: If you checked your sources from version control repository and
didn't obtain them from a release file, you also need to copy
- include/wx/msw/setup0.h to include/wx/msw/setup.h.
+ include/wx/msw/setup0.h to include/wx/msw/setup.h and to remember
+ to update the latter whenever the former changes, otherwise you
+ will get compilation errors if any new symbols are added to
+ setup0.h file in the repository.
+
+ If you have no intention of modifying setup.h, you may avoid this
+ problem by creating a symbolic link to setup0.h instead of making
+ a copy of it using mklink, from an admin command prompt:
+
+ cd include/wx/msw/
+ mklink setup.h setup0.h
+
Building wxWidgets
@@ -112,25 +123,33 @@ currently. If you want to build Win64 libraries with the previous
compiler versions, the simplest solution is to use the makefiles as
described above.
-Special note for VC11 and VC12 projects: it is possible to customize the build
-by creating wx_vcN_local.props (N=11 or 12) file in build\msw directory which
-is used, if it exists, by the projects. The settings in this file override the
-default values for the properties such as wxCfg (corresponding to the CFG
-makefile variable described below) or wxVendor (corresponding to VENDOR). For
-example, you could set wxCompilerPrefix to "vc120" in your local properties
-file:
-
-
-
- vc120
-
-
+Special notes for Visual Studio 2010+:
-to use "vc120" prefix for the build directories used by VC12 and so to allow
-its build files to coexist with the files produced by the other MSVC versions.
-Notice that by using a separate local props file you ensure that your changes
-won't be lost when updating to a future wxWidgets version.
+For Visual Studio 2010+ solutions it is possible to customize the build by
+creating a wx_local.props file in the build\msw directory which is used, if it
+exists, by the projects. The settings in that file override the default values
+for the properties such as wxCfg (corresponding to the CFG makefile variable
+described below) or wxVendor (corresponding to VENDOR). The typical way to
+make the file is to copy wx_setup.props to wx_local.props and then edit local.
+
+For example, if you are building wxWidgets libraries using multiple versions
+of Visual Studio you could change wxCompilerPrefix to include the toolset:
+
+- vc
++ vc$(PlatformToolsetVersion)
+
+Following that example if you are using Visual Studio 2013 and open
+wx_vc12.sln it will build using the "vc120" prefix for the build directories
+so to allow its build files to coexist with the files produced by the other
+MSVC versions.
+
+Keep in mind that by using a separate local props file you ensure that your
+changes won't be lost when updating to a future wxWidgets version. But if
+wx_setup.props is updated in some later commit your wx_local.props is not
+updated with it. For example the version information in wx_setup.props could
+change and the information in your wx_local.props would be outdated. It is
+your responsibility to monitor for such situations.
Cygwin/MinGW Compilation