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
___________________________________________________________________________ Sent via: Wireshark-dev mailing list <wireshark-dev@wireshark.org> Archives: http://www.wireshark.org/lists/wireshark-dev Unsubscribe: https://wireshark.org/mailman/options/wireshark-dev mailto:wireshark-dev-requ...@wireshark.org?subject=unsubscribe