Enhance build instructions on Windows
Signed-off-by: Andre Muezerie <andre...@linux.microsoft.com>
---
v3:
- Recommended Meson version to use and removed mention about old bug.
- Set VS developer prompt to produce 64 bit binaries if needed.
v2:
- provide Meson version that works
.mailmap | 1 +
doc/guides/windows_gsg/build_dpdk.rst | 19 ++++++++++++++-----
2 files changed, 15 insertions(+), 5 deletions(-)
diff --git a/.mailmap b/.mailmap
index 5290420..60db768 100644
--- a/.mailmap
+++ b/.mailmap
@@ -98,6 +98,7 @@ Anatolii Gerasymenko <anatolii.gerasyme...@intel.com>
Anatoly Burakov <anatoly.bura...@intel.com>
Anbarasan Murugesan <anbarasanx.muruge...@intel.com>
Anders Roxell <anders.rox...@linaro.org>
+Andre Muezerie <andre...@linux.microsoft.com> <andre...@microsoft.com>
Andrea Arcangeli <aarca...@redhat.com>
Andrea Grandi <andrea.gra...@intel.com>
Andre Richter <andre.o.rich...@gmail.com>
diff --git a/doc/guides/windows_gsg/build_dpdk.rst
b/doc/guides/windows_gsg/build_dpdk.rst
index 708875c..c81a818 100644
--- a/doc/guides/windows_gsg/build_dpdk.rst
+++ b/doc/guides/windows_gsg/build_dpdk.rst
@@ -72,10 +72,7 @@ A good option to choose is the MSI installer for both meson
and ninja together::
http://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer%22
-Required version is Meson 0.57.
-
-Versions starting from 0.58 are unusable with LLVM toolchain
-because of a `Meson issue <https://github.com/mesonbuild/meson/issues/8981>`_.
+Meson version 1.5.2 or newer is recommended.
Install the Backend
@@ -129,11 +126,23 @@ Depending on the distribution, paths in this file may
need adjustments.
Option 3. Native Build on Windows using MSVC
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Open a 'Developer PowerShell for VS 2022' prompt from the start menu.
+Open a 'Visual Studio Developer Command Prompt'.
The developer prompt will configure the environment
to select the appropriate compiler, linker and SDK paths
required to build with Visual Studio 2022.
+Windows 32-bit is currently not supported, so if your Visual Studio
environment defaults
+to 32-bits you can instruct the toolset to produce 64-bit binaries using
"-arch" parameter.
+For more details about the Developer Prompt options look at the `Visual Studio
Developer
+Command Prompt and Developer PowerShell
+<https://learn.microsoft.com/en-us/visualstudio/ide/reference/command-prompt-powershell?view=vs-2022>`_.
+
+.. code-block:: console
+
+ "C:\Program Files\Microsoft Visual
Studio\2022\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64
+
+Compile the code from the developer prompt.
+
.. code-block:: console
cd C:\Users\me\dpdk
--
1.8.3.1
