[dpdk-dev] [PATCH v1] doc: update release notes for 18.05

Thomas Monjalon thomas at monjalon.net
Wed May 30 22:54:52 CEST 2018


30/05/2018 22:25, John McNamara:
> Fix grammar, spelling and formatting of DPDK 18.05 release notes.
> 
> Signed-off-by: John McNamara <john.mcnamara at intel.com>

Applied with few more changes below, thanks.

--- b/doc/guides/rel_notes/release_18_05.rst
+++ a/doc/guides/rel_notes/release_18_05.rst
@@ -350,7 +350,7 @@ API Changes
    Also, make sure to start the actual text at the margin.
    =========================================================
 
-* service cores: Service cores no longer marked as experimental.
+* service cores: No longer marked as experimental.
 
   The service cores functions are no longer marked as experimental, and have
   become part of the normal DPDK API and ABI. Any future ABI changes will be
@@ -412,7 +412,7 @@ API Changes
 * ethdev: In struct ``struct rte_eth_dev_info``, field ``rte_pci_device *pci_dev``
   has been replaced with field ``struct rte_device *device``.
 
-* Changes to the semantics of ``rte_eth_dev_configure()`` parameters.
+* ethdev: Changes to the semantics of ``rte_eth_dev_configure()`` parameters.
 
   If both the ``nb_rx_q`` and ``nb_tx_q`` parameters are zero,
   ``rte_eth_dev_configure()`` will now use PMD-recommended queue sizes, or if
@@ -420,7 +420,7 @@ API Changes
   fall-back values. Previously setting both of the parameters to zero would
   have resulted in ``-EINVAL`` being returned.
 
-* Changes to the semantics of ``rte_eth_rx_queue_setup()`` parameters.
+* ethdev: Changes to the semantics of ``rte_eth_rx_queue_setup()`` parameters.
 
   If the ``nb_rx_desc`` parameter is zero, ``rte_eth_rx_queue_setup`` will
   now use the PMD-recommended Rx ring size, or in the case where the PMD
@@ -428,7 +428,7 @@ API Changes
   fall-back value. Previously, setting ``nb_rx_desc`` to zero would have
   resulted in an error.
 
-* Changes to the semantics of ``rte_eth_tx_queue_setup()`` parameters.
+* ethdev: Changes to the semantics of ``rte_eth_tx_queue_setup()`` parameters.
 
    If the ``nb_tx_desc`` parameter is zero, ``rte_eth_tx_queue_setup`` will
    now use the PMD-recommended Tx ring size, or in the case where the PMD
@@ -436,7 +436,7 @@ API Changes
    fall-back value. Previously, setting ``nb_tx_desc`` to zero would have
    resulted in an error.
 
-* ethdev: several changes were made to the flow API.
+* ethdev: Several changes were made to the flow API.
 
   * The unused DUP action was removed.
   * Actions semantics in flow rules: list order now matters ("first
@@ -479,12 +479,12 @@ API Changes
   * ``RTE_FLOW_ACTION_TYPE_MARK`` item type has been added to match a flow against
     a previously marked flow.
 
-* ethdev: change flow APIs regarding count action:
+* ethdev: Change flow APIs regarding count action:
 
   * ``rte_flow_create()`` API count action now requires the ``struct rte_flow_action_count``.
   * ``rte_flow_query()`` API parameter changed from action type to action structure.
 
-* ethdev: changes to offload API
+* ethdev: Changes to offload API
 
    A pure per-port offloading isn't requested to be repeated in [rt]x_conf->offloads to
    ``rte_eth_[rt]x_queue_setup()``. Now any offloading enabled in ``rte_eth_dev_configure()``
@@ -492,7 +492,7 @@ API Changes
    not been enabled in ``rte_eth_dev_configure()`` and is requested to be enabled in
    ``rte_eth_[rt]x_queue_setup()`` must be per-queue type, or otherwise trigger an error log.
 
-* ethdev: runtime queue setup:
+* ethdev: Runtime queue setup
 
   ``rte_eth_rx_queue_setup`` and ``rte_eth_tx_queue_setup`` can be called after
   ``rte_eth_dev_start`` if the device supports runtime queue setup. The device driver can
@@ -520,7 +520,7 @@ ABI Changes
   structure and the offset of the fields remains the same on platforms
   with 64B cache line, but changes on other platforms.
 
-* mempool: Some Ops have changed.
+* mempool: Some ops have changed.
 
   A new callback ``calc_mem_size`` has been added to ``rte_mempool_ops``
   to allow customization of the required memory size calculation.
@@ -532,7 +532,7 @@ ABI Changes
   Callback ``register_memory_area`` has been removed from ``rte_mempool_ops``
   since the new callback ``populate`` may be used instead of it.
 
-* **Additional fields in rte_eth_dev_info.**
+* ethdev: Additional fields in rte_eth_dev_info.
 
   The ``rte_eth_dev_info`` structure has had two extra entries appended to the
   end of it: ``default_rxportconf`` and ``default_txportconf``. Each of these
@@ -553,32 +553,19 @@ ABI Changes
   sanity fix in the VLAN pattern item (``struct rte_flow_item_vlan``) and
   new transfer attribute (``struct rte_flow_attr``).
 
-**New parameter added to rte_bbdev_op_cap_turbo_dec.**
+* bbdev: New parameter added to rte_bbdev_op_cap_turbo_dec.
 
   A new parameter ``max_llr_modulus`` has been added to
   ``rte_bbdev_op_cap_turbo_dec`` structure to specify maximal LLR (likelihood
   ratio) absolute value.
 
-* **BBdev Queue Groups split into UL/DL Groups.**
+* bbdev: Queue Groups split into UL/DL Groups.
 
   Queue Groups have been split into UL/DL Groups in the Turbo Software Driver.
   They are independent for Decode/Encode. ``rte_bbdev_driver_info`` reflects
   introduced changes.
 
 
-Removed Items
--------------
-
-.. This section should contain removed items in this release. Sample format:
-
-   * Add a short 1-2 sentence description of the removed item in the past
-     tense.
-
-   This section is a comment. Do not overwrite or remove it.
-   Also, make sure to start the actual text at the margin.
-   =========================================================
-
-
 Known Issues
 ------------
 






More information about the dev mailing list