Hi folks,
after my recent attempts to build Wireshark on Windows I figured that
some doc updates might be appropriate.
They are attached. If they look good can someone commit them.
The main bit is adding a list of known traps in the warning at the
very beginning and a claim that they are now known to work.
--
Regards,
Richard Sharpe
(何以解憂？唯有杜康。--曹操)
diff --git a/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc b/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
index 4f51128..88cfa4c 100644
--- a/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
+++ b/docbook/wsdg_src/WSDG_chapter_quick_setup.asciidoc
@@ -31,7 +31,16 @@ configuration.
[WARNING]
====
Unless you know exactly what you are doing, you
-should strictly follow the recommendations below.
+should strictly follow the recommendations below. They are known to work
+and if the build breaks, please re-read this guide carefully.
+
+Known traps are:
+
+. Not using the correct (x86 or x64) version of the Visual Studio command prompt.
+
+. Not copying win32.mak to the newer versions of the SDK.
+
+. Not downloading the correct version of vcredist_xYY.exe.
====
[[ChSetupMSVC]]
@@ -60,6 +69,7 @@ It's possible to compile Wireshark with a wide range
of Microsoft C compiler variants. For details see
<<ChToolsMSChain>>!
+[TIP]
For VS2013 (and later) Microsoft has left out a required file from the
include files to build with nmake. To fix this copy Win32.Mak from the Win 7 SDK
into an appropriate path for use with VS2013, e.g.
@@ -332,7 +342,7 @@ Make sure your repository path doesn't contain spaces.
From the Start Menu (or Start Screen), navigate to the Visual Studio 2013 ->
Visual Studio Tools directory and choose the Command Prompt appropriate for
-the build you wish to make, e.g. VS2013 x86 Native Tools Command Prompt for a 32 bit version.
+the build you wish to make, e.g. VS2013 x86 Native Tools Command Prompt for a 32-bit version, VS2014 x64 Native Tools Command Prompt for a 64-bit version.
[TIP]
.Pin the items to the Task Bar
@@ -517,6 +527,8 @@ You may check the `MAKENSIS` setting in the file 'config.nmake' in the Wireshark
sources. Note that the 32-bit version of NSIS will work for both 32-bit and
64-bit versions of Wireshark.
+Note: If you do not yet have a copy of vcredist_x86.exe or vcredist_x64.exe in ./wireshark-winXX-libs (where XX is 32 or 64) you will need to download the appropriate file and place it in ./wireshark-winXX-libs before starting this step.
+
. If you've closed the Visual Studio Command Prompt <<ChSetupPrepareCommandCom,prepare>> it again.
. Run