[PATCH] doc/linux_gsg: update recommended compiler versions

[PATCH] doc/linux_gsg: update recommended compiler versions

[Bruce Richardson]

Rather than specifying a minimum compiler version, update the docs to
recommend a particular compiler version. In other words, earlier
versions may work, but are not officially supported, or may give reduced
functionality.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst
index 4c9d0c55c0..0acd26f260 100644
--- a/doc/guides/linux_gsg/sys_reqs.rst
+++ b/doc/guides/linux_gsg/sys_reqs.rst
@@ -28,7 +28,8 @@ Compilation of the DPDK
     For details on Linux distributions and the versions tested, please consult the DPDK Release Notes.
 
 *   General development tools including a C compiler supporting the C11 standard,
-    including standard atomics, for example: GCC (version 5.0+) or Clang (version 3.6+),
+    including standard atomics, for example:
+    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
     and ``pkg-config`` or ``pkgconf`` to be used when building end-user binaries against DPDK.
 
     * For RHEL/Fedora systems these can be installed using ``dnf groupinstall "Development Tools"``
-- 
2.45.2

RE: [PATCH] doc/linux_gsg: update recommended compiler versions

[Morten Brørup]

> From: Bruce Richardson [mailto:bruce.richardson@intel.com]
> Sent: Tuesday, 8 April 2025 19.19
> 
> Rather than specifying a minimum compiler version, update the docs to
> recommend a particular compiler version. In other words, earlier
> versions may work, but are not officially supported, or may give
> reduced
> functionality.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>  doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/doc/guides/linux_gsg/sys_reqs.rst
> b/doc/guides/linux_gsg/sys_reqs.rst
> index 4c9d0c55c0..0acd26f260 100644
> --- a/doc/guides/linux_gsg/sys_reqs.rst
> +++ b/doc/guides/linux_gsg/sys_reqs.rst
> @@ -28,7 +28,8 @@ Compilation of the DPDK
>      For details on Linux distributions and the versions tested, please
> consult the DPDK Release Notes.
> 
>  *   General development tools including a C compiler supporting the
> C11 standard,
> -    including standard atomics, for example: GCC (version 5.0+) or
> Clang (version 3.6+),
> +    including standard atomics, for example:
> +    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
>      and ``pkg-config`` or ``pkgconf`` to be used when building end-
> user binaries against DPDK.
> 
>      * For RHEL/Fedora systems these can be installed using ``dnf
> groupinstall "Development Tools"``
> --
> 2.45.2

Acked-by: Morten Brørup <mb@smartsharesystems.com>

Re: [PATCH] doc/linux_gsg: update recommended compiler versions

[Thomas Monjalon]

08/04/2025 19:18, Bruce Richardson:
> Rather than specifying a minimum compiler version, update the docs to
> recommend a particular compiler version. In other words, earlier
> versions may work, but are not officially supported, or may give reduced
> functionality.
[...]
> +    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),

Please could you explain in the commit log why these versions are recommended?

[PATCH v2] doc/linux_gsg: update recommended compiler versions

[Bruce Richardson]

Rather than specifying a minimum compiler version, update the docs to
recommend a particular compiler version. In other words, earlier
versions may work, but are not officially supported, or may give reduced
functionality.

Since we don't require that many version-specific features, recommend
the compiler verions included in our oldest officially-supported distro.
Those versions (GCC 8 & Clang 7) provide all needed functionality.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Acked-by: Morten Brørup <mb@smartsharesystems.com>
---
 doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/guides/linux_gsg/sys_reqs.rst b/doc/guides/linux_gsg/sys_reqs.rst
index 4c9d0c55c0..0acd26f260 100644
--- a/doc/guides/linux_gsg/sys_reqs.rst
+++ b/doc/guides/linux_gsg/sys_reqs.rst
@@ -28,7 +28,8 @@ Compilation of the DPDK
     For details on Linux distributions and the versions tested, please consult the DPDK Release Notes.
 
 *   General development tools including a C compiler supporting the C11 standard,
-    including standard atomics, for example: GCC (version 5.0+) or Clang (version 3.6+),
+    including standard atomics, for example:
+    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
     and ``pkg-config`` or ``pkgconf`` to be used when building end-user binaries against DPDK.
 
     * For RHEL/Fedora systems these can be installed using ``dnf groupinstall "Development Tools"``
-- 
2.48.1