From 4778386e71ef1c57fc6b9bdd2be5e18b490531e6 Mon Sep 17 00:00:00 2001 From: Gerald Combs Date: Thu, 2 Jan 2020 10:24:33 -0800 Subject: WSDG: Miscellaneous updates. Add a note about case sensitive directories on Windows. Recommend the "winflexbison3" Chocolatey package. Update our list of Linux distributions. Change-Id: I4676453941a66de71215d6ce6cf7057623c92fec Reviewed-on: https://code.wireshark.org/review/35622 Reviewed-by: Alexis La Goutte Reviewed-by: Gerald Combs --- docbook/wsdg_src/WSDG_chapter_env_intro.adoc | 37 +++++++++++++------------- docbook/wsdg_src/WSDG_chapter_quick_setup.adoc | 4 +-- docbook/wsdg_src/WSDG_chapter_tools.adoc | 2 +- 3 files changed, 21 insertions(+), 22 deletions(-) diff --git a/docbook/wsdg_src/WSDG_chapter_env_intro.adoc b/docbook/wsdg_src/WSDG_chapter_env_intro.adoc index 993d85dc7f..b892022c6d 100644 --- a/docbook/wsdg_src/WSDG_chapter_env_intro.adoc +++ b/docbook/wsdg_src/WSDG_chapter_env_intro.adoc @@ -57,6 +57,8 @@ others: ===== Linux +* Arch Linux + * Debian GNU/Linux * Ubuntu @@ -67,35 +69,33 @@ others: * IBM S/390 Linux (Red Hat) -* Mandrake Linux +* Mandriva Linux * PLD Linux * Red Hat Linux -* Rock Linux - * Slackware Linux * Suse Linux ==== Microsoft Windows -Wireshark supports Windows natively via the -https://en.wikipedia.org/wiki/Windows_API[Windows API]. Note that in -this documentation and elsewhere we tend to use the terms -“Win32”, “Win”, and “Windows” interchangeably to refer to the -Windows API. Wireshark runs on and can be compiled on the following -platforms: +Wireshark supports Windows natively via the https://en.wikipedia.org/wiki/Windows_API[Windows API]. +Note that in this documentation and elsewhere we tend to use the terms “Win32”, “Win”, and “Windows” interchangeably to refer to the Windows API. +“Win64” refers to the Windows API on 64-bit platforms. +Wireshark runs on and can be compiled on the following Windows versions: -* Windows 10 / Windows Server 2016 +* Windows 10 / Windows Server 2016 / Windows Server 2019 * Windows 8.1 / Windows Server 2012 R2 * Windows 8 / Windows Server 2012 -Development on Windows 7, Server 2008 R2, Vista, Server 2008, and older versions may be possible but -is not supported. +Development on Windows 7, Server 2008 R2, Vista, Server 2008, and older versions may be possible but is not supported. + +Some versions of Windows support https://devblogs.microsoft.com/commandline/per-directory-case-sensitivity-and-wsl/[case sensitive directories]. +We don’t officially support building or running Wireshark in this environment, but we will accept patches to fix any issues that might arise. [[ChIntroDevelopment]] @@ -294,22 +294,21 @@ Each step is represented at the status page by a rectangle, green if it succeeded or red if it failed. Most steps provide a link to the corresponding console logfile, to get additional information. -The Buildbot runs on a platform collection that represents the different -"platform specialties" quite well: +Release packages are built on the following platforms: -* Windows Server 2019 x86 (Win32, little endian, Visual Studio 2017) +* Windows Server 2019 x86-64 (Win32, little endian, Visual Studio 2019) -* Windows Server 2016 x86-64 (Win64, little endian, Visual Studio 2017) +* Windows Server 2019 x86-64 (Win64, little endian, Visual Studio 2019) * Ubuntu 18.04 x86-64 (Linux, little endian, gcc, Clang) * macOS 10.14 x86-64 (BSD, little endian, Clang) -and two buildslaves that run static code analysis to help spot coding issues: +Static code analysis and fuzz tests are run on the following platforms: -* Visual Studio Code Analysis (Win64, little endian, VS 2017) +* Visual Studio Code Analysis (Win64, little endian, VS 2019) -* Clang Code Analysis (Linux, little endian, Clang) +* Clang Code Analysis, Coverity Scan, and fuzz tests (Linux, little endian, Clang) Each platform is represented at the status page by a single column, the most recent entries are at the top. diff --git a/docbook/wsdg_src/WSDG_chapter_quick_setup.adoc b/docbook/wsdg_src/WSDG_chapter_quick_setup.adoc index db8d1d81d0..6087e6da0f 100644 --- a/docbook/wsdg_src/WSDG_chapter_quick_setup.adoc +++ b/docbook/wsdg_src/WSDG_chapter_quick_setup.adoc @@ -61,7 +61,7 @@ command `choco install` (or its shorthand, `cinst`), e.g. [source,cmd] ---- > rem Flex and Bison are required. -> choco install -y winflexbison +> choco install -y winflexbison3 > rem Git, CMake, Perl, Python, etc are also required, but can be installed > rem via their respective installation packages. > choco install -y git cmake strawberryperl python3 @@ -253,7 +253,7 @@ and win_bison.exe is on your path. Alternatively you can install Winflexbison using Chocolatey: ---- -PS$> choco install -y winflexbison +PS$> choco install -y winflexbison3 ---- Chocolatey ensures win_flex.exe and win_bison.exe are on your path. diff --git a/docbook/wsdg_src/WSDG_chapter_tools.adoc b/docbook/wsdg_src/WSDG_chapter_tools.adoc index fb0d02d522..e77f43e364 100644 --- a/docbook/wsdg_src/WSDG_chapter_tools.adoc +++ b/docbook/wsdg_src/WSDG_chapter_tools.adoc @@ -800,7 +800,7 @@ Your version string may vary. [discrete] ==== Windows -A native Windows version of bison is available in the _winflexbison_ +A native Windows version of bison is available in the _winflexbison3_ https://chocolatey.org/[Chocolatey] package. Note that the executable is named _win_bison_. -- cgit v1.2.3