aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGerald Combs <gerald@wireshark.org>2020-01-02 10:24:33 -0800
committerGerald Combs <gerald@wireshark.org>2020-01-03 16:36:11 +0000
commit4778386e71ef1c57fc6b9bdd2be5e18b490531e6 (patch)
tree40c86d0924185f32fe5d9d56fba12dad8d3ec79d
parent76dfe6004b7cc7e0c90b962a74cdc180bb0b4c7f (diff)
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 <alexis.lagoutte@gmail.com> Reviewed-by: Gerald Combs <gerald@wireshark.org>
-rw-r--r--docbook/wsdg_src/WSDG_chapter_env_intro.adoc37
-rw-r--r--docbook/wsdg_src/WSDG_chapter_quick_setup.adoc4
-rw-r--r--docbook/wsdg_src/WSDG_chapter_tools.adoc2
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_.