[PATCH 2/2] doc: add MSYS2 building guide

[PATCH 2/2] doc: add MSYS2 building guide

[Ric Li]

Introduce guide for using MSYS2 to build DPDK on Windows.
MSYS2 provides a Unix-like environment on Windows and
its package manager simplifies tool and dependency
installation, aiding Linux program migration.

Signed-off-by: Ric Li <ricmli@outlook.com>
---
 doc/guides/windows_gsg/build_dpdk.rst | 36 +++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst
index 29f2b38feb..27dff76efe 100644
--- a/doc/guides/windows_gsg/build_dpdk.rst
+++ b/doc/guides/windows_gsg/build_dpdk.rst
@@ -12,6 +12,7 @@ environments:
 
 * The Clang-LLVM C compiler and Microsoft MSVC linker.
 * The MinGW-w64 toolchain (either native or cross).
+* MSYS2 with the MINGW64/UCRT64 environment.
 
 The Meson Build system is used to prepare the sources for compilation
 with the Ninja backend.
@@ -55,6 +56,39 @@ Install to a folder without spaces in its name, like ``C:\MinGW``.
 This path is assumed for the rest of this guide.
 
 
+Option 3. MSYS2 with the MINGW64/UCRT64 Environment
+---------------------------------------------------
+
+Install MSYS2
+~~~~~~~~~~~~~
+
+Download and install MSYS2 from
+`MSYS2 website <https://www.msys2.org>`_.
+
+Follow the installation instructions provided on the MSYS2 website
+to set up the base system.
+Make sure to update the package database using the
+following commands in the MSYS2 terminal:
+
+.. code-block:: console
+
+    pacman -Syu
+
+Install Build Dependencies
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Open the MSYS2 MINGW64/UCRT64 terminal and use the package manager
+to install the required build tools and dependencies:
+
+.. code-block:: console
+
+    pacman -S git pactoys
+    pacboy -S meson:p gcc:p pkg-config:p
+
+Meson and Ninja are already installed via the package manager,
+so you can proceed with building the code.
+
+
 Install the Build System
 ------------------------
 
@@ -99,6 +133,8 @@ When using MinGW-w64, it is sufficient to have toolchain executables in PATH:
 
     set PATH=C:\MinGW\mingw64\bin;%PATH%
 
+When using MSYS2, perform in the MSYS2 MINGW64/UCRT64 terminal.
+
 To compile the examples, the flag ``-Dexamples`` is required.
 
 .. code-block:: console
-- 
2.42.0

Re: [PATCH 2/2] doc: add MSYS2 building guide

[Stephen Hemminger]

On Sat, 16 Sep 2023 21:15:20 +0800
Ric Li <ricmli@outlook.com> wrote:

> Introduce guide for using MSYS2 to build DPDK on Windows.
> MSYS2 provides a Unix-like environment on Windows and
> its package manager simplifies tool and dependency
> installation, aiding Linux program migration.
> 
> Signed-off-by: Ric Li <ricmli@outlook.com>

I don't think this ever got accepted, because adding a third way to
build on Windows, just adds complexity (never gets tested by CI),
without a lot of benefit to end users.

If it gets added to the documentation, it has to be continuously
tested or it will get broken.