[PATCH 0/6] doc/rel_notes: updates to 26.07 doc

[PATCH 0/6] doc/rel_notes: updates to 26.07 doc

[Bruce Richardson]

A collection of miscellaneous updates and fixes for the 26.07 release notes.

Bruce Richardson (6):
  doc/rel_notes: remove bullets for single items
  doc/rel_notes: move mempool change to first item
  doc/rel_notes: keep library updates together
  doc/rel_notes: fix driver ordering
  doc/rel_notes: fix style of API changes section
  doc/rel_notes: minor style fixes

 doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
 1 file changed, 69 insertions(+), 74 deletions(-)

--
2.53.0

[PATCH 1/6] doc/rel_notes: remove bullets for single items

[Bruce Richardson]

For release note component updates where only a single item is called
out, remove the bullet point character.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index 6badd6d91b..83610938bd 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -137,7 +137,7 @@ New Features
 
 * **Updated Google gve driver.**
 
-  * Added hardware timestamping support on DQO queues.
+  Added hardware timestamping support on DQO queues.
 
 * **Updated Intel iavf driver.**
 
@@ -147,18 +147,18 @@ New Features
 
 * **Updated Intel ice driver.**
 
-  * Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
-    burst size, reducing Tx latency jitter for time-sensitive traffic.
+  Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
+  burst size, reducing Tx latency jitter for time-sensitive traffic.
 
 * **Updated Microsoft mana driver.**
 
-  * Added device reset support to the MANA PMD,
-    doing automatic recovery from hardware service reset events,
-    and notification to upper layers of the reset lifecycle.
+  Added device reset support to the MANA PMD,
+  doing automatic recovery from hardware service reset events,
+  and notification to upper layers of the reset lifecycle.
 
 * **Updated NVIDIA mlx5 ethernet driver.**
 
-  * Added support for selective Rx in scalar SPRQ Rx path.
+  Added support for selective Rx in scalar SPRQ Rx path.
 
 * **Updated NXP dpaa2 driver.**
 
@@ -192,14 +192,14 @@ New Features
 
 * **Updated Marvell cnxk crypto driver.**
 
-  * Added support for ML-KEM and ML-DSA on CN20K platform.
+  Added support for ML-KEM and ML-DSA on CN20K platform.
 
 * **Updated Wangxun ngbe driver.**
 
-  * Implemented UDP Segmentation Offload (USO) in the transmit path.
-    The ``RTE_ETH_TX_OFFLOAD_UDP_TSO`` capability was advertised
-    since the driver's initial integration but the data path was missing;
-    it is now functional.
+  Implemented UDP Segmentation Offload (USO) in the transmit path.
+  The ``RTE_ETH_TX_OFFLOAD_UDP_TSO`` capability was advertised
+  since the driver's initial integration but the data path was missing;
+  it is now functional.
 
 * **Updated Wangxun txgbe driver.**
 
-- 
2.53.0

[PATCH 2/6] doc/rel_notes: move mempool change to first item

[Bruce Richardson]

The change in mempool behaviour is the change in this release with the
largest impact, so call that out first in the release notes, so as to
get maximum visibility for it.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 28 +++++++++++++-------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index 83610938bd..f301a8444c 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -55,20 +55,6 @@ New Features
      Also, make sure to start the actual text at the margin.
      =======================================================
 
-* **Added option to change memory limits per page size.**
-
-  Added the EAL option ``--pagesz-mem``
-  to override the default per-page-size memory limits.
-  Each maximum can be configured with a pair ``<pagesz>:<limit>``.
-
-* **Added option to disable auto probing.**
-
-  Added EAL options affecting the initial bus probing.
-
-  * ``-A`` or ``--no-auto-probing`` disable the initial bus probing: no device is probed during
-    ``rte_eal_init`` and the application is responsible for probing each device,
-  * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
-
 * **Changed mempool cache behaviour.**
 
   * The mempool cache flush/refill algorithm was improved,
@@ -83,6 +69,20 @@ New Features
   * The size of the ``struct rte_mempool_cache`` was kept
     for API/ABI compatibility purposes.
 
+* **Added option to change memory limits per page size.**
+
+  Added the EAL option ``--pagesz-mem``
+  to override the default per-page-size memory limits.
+  Each maximum can be configured with a pair ``<pagesz>:<limit>``.
+
+* **Added option to disable device auto probing.**
+
+  Added EAL options affecting the initial bus probing to find devices.
+
+  * ``-A`` or ``--no-auto-probing`` disables the initial bus probing: no device is probed during
+    ``rte_eal_init`` and the application is responsible for probing each device,
+  * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
+
 * **Added RISC-V vector paths.**
 
   * Increased the default SIMD bitwidth to allow using the vector extension.
-- 
2.53.0

[PATCH 3/6] doc/rel_notes: keep library updates together

[Bruce Richardson]

Group all library updates and enhancements together before driver
updates in the release notes.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 64 +++++++++++++-------------
 1 file changed, 32 insertions(+), 32 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index f301a8444c..63693159fd 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -97,6 +97,38 @@ New Features
   This allows the user to inspect objects in the ring without removing them
   (aka MT safe peek).
 
+* **Updated lcore validation in power library.**
+
+  Lcore ID validation was moved into the cpufreq framework before driver dispatch.
+  Power QoS API was updated to accept service lcores.
+
+* **Extended BPF API.**
+
+  * Added an extensible BPF loading API comprising the function
+    ``rte_bpf_load_ex`` and struct ``rte_bpf_prm_ex``.
+    This enables new features such as loading classic BPF (cBPF),
+    loading ELF images directly from memory buffers,
+    and executing multi-argument programs, while avoiding future ABI breakages.
+  * Added support for loading and executing BPF programs with up to 5 arguments.
+    This introduces new API functions ``rte_bpf_exec_ex``,
+    ``rte_bpf_exec_burst_ex``, and ``rte_bpf_get_jit_ex``.
+  * Added API functions ``rte_bpf_eth_rx_install`` and ``rte_bpf_eth_tx_install``
+    for installing already loaded BPF programs as port callbacks
+    (as opposed to loading them directly from ELF files).
+
+* **Added BPF validation debugging API and hardened BPF validator.**
+
+  * Introduced a new API (prefixed with ``rte_bpf_validate_debug_``)
+    to introspect the BPF validator.
+    This provides a mechanism to set breakpoints or catchpoints during validation
+    and inspect the verifier's internal state (such as tracked register bounds).
+    This API is crucial primarily for writing comprehensive tests for the validator,
+    but also serves as a foundation for a future interactive eBPF validation debugger.
+  * Fixed numerous bugs in the BPF validator's abstract interpretation logic,
+    including incorrect bounds tracking for jumps and arithmetic operations,
+    as well as fixing several instances of undefined behavior (UB)
+    when verifying malicious or corrupt programs.
+
 * **Added PTP protocol definitions.**
 
   Added IEEE 1588 Precision Time Protocol header structures, constants,
@@ -224,38 +256,6 @@ New Features
 
   On ARM, both IPsec MB and OpenSSL are required for full functionality.
 
-* **Updated lcore validation in power library.**
-
-  Lcore ID validation was moved into the cpufreq framework before driver dispatch.
-  Power QoS API was updated to accept service lcores.
-
-* **Extended BPF API.**
-
-  * Added an extensible BPF loading API comprising the function
-    ``rte_bpf_load_ex`` and struct ``rte_bpf_prm_ex``.
-    This enables new features such as loading classic BPF (cBPF),
-    loading ELF images directly from memory buffers,
-    and executing multi-argument programs, while avoiding future ABI breakages.
-  * Added support for loading and executing BPF programs with up to 5 arguments.
-    This introduces new API functions ``rte_bpf_exec_ex``,
-    ``rte_bpf_exec_burst_ex``, and ``rte_bpf_get_jit_ex``.
-  * Added API functions ``rte_bpf_eth_rx_install`` and ``rte_bpf_eth_tx_install``
-    for installing already loaded BPF programs as port callbacks
-    (as opposed to loading them directly from ELF files).
-
-* **Added BPF validation debugging API and hardened BPF validator.**
-
-  * Introduced a new API (prefixed with ``rte_bpf_validate_debug_``)
-    to introspect the BPF validator.
-    This provides a mechanism to set breakpoints or catchpoints during validation
-    and inspect the verifier's internal state (such as tracked register bounds).
-    This API is crucial primarily for writing comprehensive tests for the validator,
-    but also serves as a foundation for a future interactive eBPF validation debugger.
-  * Fixed numerous bugs in the BPF validator's abstract interpretation logic,
-    including incorrect bounds tracking for jumps and arithmetic operations,
-    as well as fixing several instances of undefined behavior (UB)
-    when verifying malicious or corrupt programs.
-
 * **Updated testpmd application.**
 
   Added support for setting VLAN priority and CFI/DEI bits
-- 
2.53.0

Re: [PATCH 3/6] doc/rel_notes: keep library updates together

[Thomas Monjalon]

21/07/2026 17:13, Bruce Richardson:
> Group all library updates and enhancements together before driver
> updates in the release notes.

The suggested order in the release notes is:
     * Core libs (EAL, mempool, ring, mbuf, buses)
     * Device abstraction libs and PMDs (ordered alphabetically by vendor name)
       - ethdev (lib, PMDs)
       - cryptodev (lib, PMDs)
       - eventdev (lib, PMDs)
       - etc
     * Other libs
     * Apps, Examples, Tools (if significant)

So it was placed here on purpose.

Re: [PATCH 3/6] doc/rel_notes: keep library updates together

[Bruce Richardson]

On Tue, Jul 21, 2026 at 09:37:19PM +0200, Thomas Monjalon wrote:
> 21/07/2026 17:13, Bruce Richardson:
> > Group all library updates and enhancements together before driver
> > updates in the release notes.
> 
> The suggested order in the release notes is:
>      * Core libs (EAL, mempool, ring, mbuf, buses)
>      * Device abstraction libs and PMDs (ordered alphabetically by vendor name)
>        - ethdev (lib, PMDs)
>        - cryptodev (lib, PMDs)
>        - eventdev (lib, PMDs)
>        - etc
>      * Other libs
>      * Apps, Examples, Tools (if significant)
> 
> So it was placed here on purpose.
> 
Ok, my bad. Drop this patch so.

/Bruce

[PATCH 4/6] doc/rel_notes: fix driver ordering

[Bruce Richardson]

The drivers should be in alphabetical order by category in the release
notes, so move two drivers to give correct ordering.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index 63693159fd..b3c23b73a1 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -163,10 +163,6 @@ New Features
   to support adding and removing memory regions without resetting
   the whole guest memory map.
 
-* **Added LinkData sxe2 ethernet driver.**
-
-  Added network driver for the LinkData network adapters.
-
 * **Updated Google gve driver.**
 
   Added hardware timestamping support on DQO queues.
@@ -182,6 +178,10 @@ New Features
   Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
   burst size, reducing Tx latency jitter for time-sensitive traffic.
 
+* **Added LinkData sxe2 ethernet driver.**
+
+  Added network driver for the LinkData network adapters.
+
 * **Updated Microsoft mana driver.**
 
   Added device reset support to the MANA PMD,
@@ -222,10 +222,6 @@ New Features
   * Added ``eof`` devarg to use link state to signal end of receive file input.
   * Added unit test suite.
 
-* **Updated Marvell cnxk crypto driver.**
-
-  Added support for ML-KEM and ML-DSA on CN20K platform.
-
 * **Updated Wangxun ngbe driver.**
 
   Implemented UDP Segmentation Offload (USO) in the transmit path.
@@ -256,6 +252,10 @@ New Features
 
   On ARM, both IPsec MB and OpenSSL are required for full functionality.
 
+* **Updated Marvell cnxk crypto driver.**
+
+  Added support for ML-KEM and ML-DSA on CN20K platform.
+
 * **Updated testpmd application.**
 
   Added support for setting VLAN priority and CFI/DEI bits
-- 
2.53.0

[PATCH 5/6] doc/rel_notes: fix style of API changes section

[Bruce Richardson]

The format of the API section as documented does not have headings in
bold. This simpler format is also what is used for the 25.11 and
previous release notes. Update text for 26.07 to match the documented
and previously used style.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index b3c23b73a1..fca135569f 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -317,13 +317,9 @@ API Changes
    Also, make sure to start the actual text at the margin.
    =======================================================
 
-* **eal: promoted timing-safe memory comparison from experimental to stable.**
+* eal: Promoted ``rte_memeq_timingsafe()`` from experimental to stable.
 
-  The inline function ``rte_memeq_timingsafe()`` is no longer marked experimental.
-
-* **ethdev: promoted flow metadata API from experimental to stable.**
-
-  The following ethdev symbols are no longer marked experimental:
+* ethdev: Promoted the following flow metadata symbols from experimental to stable:
 
   - ``rte_flow_dynf_metadata_register``
   - ``rte_flow_dynf_metadata_offs``
@@ -332,16 +328,15 @@ API Changes
   - ``rte_flow_dynf_metadata_get``
   - ``rte_flow_dynf_metadata_set``
 
-* **mlx5: promoted driver event and steering management APIs from experimental to stable.**
-
-  The following mlx5 functions are no longer marked experimental:
+* mlx5: Promoted the following driver event and steering management functions
+  from experimental to stable:
 
   - ``rte_pmd_mlx5_driver_event_cb_register``
   - ``rte_pmd_mlx5_driver_event_cb_unregister``
   - ``rte_pmd_mlx5_enable_steering``
   - ``rte_pmd_mlx5_disable_steering``
 
-* **ip_frag: changed handling of malformed fragments.**
+* ip_frag: Changed handling of malformed fragments.
 
   - Duplicate fragments are tolerated instead of failing reassembly.
   - Overlapping fragments are rejected on arrival rather than during reassembly.
-- 
2.53.0

[PATCH 6/6] doc/rel_notes: minor style fixes

[Bruce Richardson]

Some minor fixes for the release note text.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/release_26_07.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst
index fca135569f..47cf73e825 100644
--- a/doc/guides/rel_notes/release_26_07.rst
+++ b/doc/guides/rel_notes/release_26_07.rst
@@ -80,7 +80,7 @@ New Features
   Added EAL options affecting the initial bus probing to find devices.
 
   * ``-A`` or ``--no-auto-probing`` disables the initial bus probing: no device is probed during
-    ``rte_eal_init`` and the application is responsible for probing each device,
+    ``rte_eal_init`` and the application is responsible for probing each device.
   * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
 
 * **Added RISC-V vector paths.**
@@ -144,7 +144,7 @@ New Features
 
 * **Added no-IOMMU mode to UACCE bus.**
 
-  Added no-IOMMU mode for devices without or not enabling IOMMU/SVA.
+  Added no-IOMMU mode for devices that do not have or do not enable IOMMU/SVA support.
 
 * **Added unplug operation support to VMBUS bus.**
 
-- 
2.53.0

RE: [PATCH 0/6] doc/rel_notes: updates to 26.07 doc

[Morten Brørup]

> A collection of miscellaneous updates and fixes for the 26.07 release
> notes.
> 
> Bruce Richardson (6):
>   doc/rel_notes: remove bullets for single items
>   doc/rel_notes: move mempool change to first item
>   doc/rel_notes: keep library updates together
>   doc/rel_notes: fix driver ordering
>   doc/rel_notes: fix style of API changes section
>   doc/rel_notes: minor style fixes
> 
>  doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
>  1 file changed, 69 insertions(+), 74 deletions(-)

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

Re: [PATCH 0/6] doc/rel_notes: updates to 26.07 doc

[Thomas Monjalon]

21/07/2026 17:13, Bruce Richardson:
> A collection of miscellaneous updates and fixes for the 26.07 release notes.
> 
> Bruce Richardson (6):
>   doc/rel_notes: remove bullets for single items
>   doc/rel_notes: move mempool change to first item
>   doc/rel_notes: keep library updates together
>   doc/rel_notes: fix driver ordering
>   doc/rel_notes: fix style of API changes section
>   doc/rel_notes: minor style fixes
> 
>  doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
>  1 file changed, 69 insertions(+), 74 deletions(-)

Applied without patch 3 as discussed,
and squashed with comments removal, thanks.