From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 51D11436AB; Fri, 8 Dec 2023 16:43:40 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 1E84A40A75; Fri, 8 Dec 2023 16:43:40 +0100 (CET) Received: from mail-ej1-f54.google.com (mail-ej1-f54.google.com [209.85.218.54]) by mails.dpdk.org (Postfix) with ESMTP id B0BF140A70 for ; Fri, 8 Dec 2023 16:43:38 +0100 (CET) Received: by mail-ej1-f54.google.com with SMTP id a640c23a62f3a-a1d48f0223dso60746866b.0 for ; Fri, 08 Dec 2023 07:43:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=youngcopy-com.20230601.gappssmtp.com; s=20230601; t=1702050218; x=1702655018; darn=dpdk.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=LKg4F+9wei0F7FMjQUawaxSo+H+cq3L9rrBUISuSinY=; b=GNHgOXMHe5G09eObCYGRRhj7VwgtQhABO462nzI5GZveOwGQu8Ilg0Uw81nvhxTZ/j 4aF2Xj2b+2UiCdXNLqBMSdTlT5WZsFt2aHLeGFolaepCD7jI6YQ5clJ4EkZImERzoIKj rb/eFjOi8ZE+beC/yLjU2xo1XrSpaU/c4ucPQU6EE3o+/yBnZU/4c6yLAo3bLGYmu7hR ve+pLUJZ8eGZumcft4xvtsg2HquTaf6BvnvHbxkjeW3Qo2KriWsv6o+rP3lyRmSLkeqT a3rxzPK7b7llWwE0YL27kVyRvI9fyA1iXcO4vnj1c2MgJvqS5yJqJf8mORJvcHir3sib zdGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702050218; x=1702655018; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=LKg4F+9wei0F7FMjQUawaxSo+H+cq3L9rrBUISuSinY=; b=Q2qm5XSgN9zv4ocwbJRlymme0NwZUw97ipAZUtYlAweDNt3vFHTyg1pb72iEQXUKVT NDhceN4wA01WI3VlZcjsrScLu7REsWLuJ9tCWgCk686cyrJWLq8kYuALiO+i6JfAV9kJ 3/7QfvBLT5Nd2d/pEWPNuAClpapRK8V/nCKlxTkRC+eHYcRYC1LyStK2hHWjHHXFSw7f hdShWbrS3RH7LXQfaB563EOZCSwwoEPNXT64qIBn2rfpIfqvxGIq2zZQjt/axBfq9Sr8 KJ81jHprcy8l1VeBMVvo9V4Z3lB+UuTtpnso+S2tf1gtRqzLvgE/GHt29hPakbbaPG/u QUhA== X-Gm-Message-State: AOJu0YwVulgww+hbfVTj5UKad6BvqZj7vjqeTZ/37JEowQQzRoTom0nc VkGtGdSaRlsz/0SsoatB5daeuozo0yzA1TOKlMim2wM66sOcHc0Ohg0= X-Google-Smtp-Source: AGHT+IH9JskbSszQ0xlSugn0yLjzxOIHYxlUgoXUM+SyATKOu4ej4f+qJuIrc4te4RPdKHxj4GL6cZZukHNETarcM10= X-Received: by 2002:a17:906:ba86:b0:9f2:3e76:5d39 with SMTP id cu6-20020a170906ba8600b009f23e765d39mr256606ejd.0.1702050217348; Fri, 08 Dec 2023 07:43:37 -0800 (PST) MIME-Version: 1.0 References: <20231208021108.2001-1-dave@youngcopy.com> <20231208021108.2001-2-dave@youngcopy.com> In-Reply-To: <20231208021108.2001-2-dave@youngcopy.com> From: Dave Young Date: Fri, 8 Dec 2023 10:43:27 -0500 Message-ID: Subject: Re: [PATCH 1/1] Modified Programmer's Guide index for better organization and readability To: dev@dpdk.org Cc: Bruce Richardson , Thomas Monjalon Content-Type: multipart/alternative; boundary="000000000000986383060c017297" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org --000000000000986383060c017297 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Signed-off-by: David Young Thanks! David Young Professional Copywriter/Technical Writer Young Copy +1 (678) 500-9550 https://www.youngcopy.com On Thu, Dec 7, 2023 at 9:11=E2=80=AFPM David Young wro= te: > --- > doc/guides/prog_guide/bpf_lib.rst | 4 +- > doc/guides/prog_guide/dmadev.rst | 6 +- > doc/guides/prog_guide/efd_lib.rst | 4 +- > .../prog_guide/env_abstraction_layer.rst | 4 +- > doc/guides/prog_guide/ethdev/index.rst | 12 ++ > .../prog_guide/{ =3D> ethdev}/poll_mode_drv.rst | 0 > .../prog_guide/{ =3D> ethdev}/qos_framework.rst | 0 > .../prog_guide/{ =3D> ethdev}/rte_flow.rst | 0 > .../{ =3D> ethdev}/switch_representation.rst | 0 > .../{ =3D> ethdev}/traffic_management.rst | 0 > .../traffic_metering_and_policing.rst | 0 > .../{ =3D> eventdev}/event_crypto_adapter.rst | 0 > .../event_ethernet_rx_adapter.rst | 0 > .../event_ethernet_tx_adapter.rst | 0 > .../{ =3D> eventdev}/event_timer_adapter.rst | 0 > .../prog_guide/{ =3D> eventdev}/eventdev.rst | 2 +- > doc/guides/prog_guide/eventdev/index.rst | 11 ++ > doc/guides/prog_guide/fib_lib.rst | 4 +- > .../generic_receive_offload_lib.rst | 4 +- > .../generic_segmentation_offload_lib.rst | 4 +- > doc/guides/prog_guide/gpudev.rst | 4 +- > doc/guides/prog_guide/index.rst | 145 ++++++++++++------ > doc/guides/prog_guide/lpm6_lib.rst | 4 +- > doc/guides/prog_guide/lpm_lib.rst | 4 +- > doc/guides/prog_guide/mbuf_lib.rst | 6 +- > doc/guides/prog_guide/mempool_lib.rst | 4 +- > doc/guides/prog_guide/mldev.rst | 6 +- > .../prog_guide/packet_classif_access_ctrl.rst | 4 +- > doc/guides/prog_guide/packet_framework.rst | 4 +- > doc/guides/prog_guide/rawdev.rst | 4 +- > doc/guides/prog_guide/regexdev.rst | 4 +- > doc/guides/prog_guide/rib_lib.rst | 4 +- > ...y_dpdk_functions.rst =3D> thread_safety.rst} | 4 +- > 33 files changed, 166 insertions(+), 86 deletions(-) > create mode 100644 doc/guides/prog_guide/ethdev/index.rst > rename doc/guides/prog_guide/{ =3D> ethdev}/poll_mode_drv.rst (100%) > rename doc/guides/prog_guide/{ =3D> ethdev}/qos_framework.rst (100%) > rename doc/guides/prog_guide/{ =3D> ethdev}/rte_flow.rst (100%) > rename doc/guides/prog_guide/{ =3D> ethdev}/switch_representation.rst (1= 00%) > rename doc/guides/prog_guide/{ =3D> ethdev}/traffic_management.rst (100%= ) > rename doc/guides/prog_guide/{ =3D> > ethdev}/traffic_metering_and_policing.rst (100%) > rename doc/guides/prog_guide/{ =3D> eventdev}/event_crypto_adapter.rst > (100%) > rename doc/guides/prog_guide/{ =3D> eventdev}/event_ethernet_rx_adapter.= rst > (100%) > rename doc/guides/prog_guide/{ =3D> eventdev}/event_ethernet_tx_adapter.= rst > (100%) > rename doc/guides/prog_guide/{ =3D> eventdev}/event_timer_adapter.rst (1= 00%) > rename doc/guides/prog_guide/{ =3D> eventdev}/eventdev.rst (99%) > create mode 100644 doc/guides/prog_guide/eventdev/index.rst > rename doc/guides/prog_guide/{thread_safety_dpdk_functions.rst =3D> > thread_safety.rst} (98%) > > diff --git a/doc/guides/prog_guide/bpf_lib.rst > b/doc/guides/prog_guide/bpf_lib.rst > index 1cf2d59429..8c820328b9 100644 > --- a/doc/guides/prog_guide/bpf_lib.rst > +++ b/doc/guides/prog_guide/bpf_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2018 Intel Corporation. > > -Berkeley Packet Filter Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D > +Berkeley Packet Filter (BPF) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The DPDK provides an BPF library that gives the ability > to load and execute Enhanced Berkeley Packet Filter (eBPF) bytecode with= in > diff --git a/doc/guides/prog_guide/dmadev.rst > b/doc/guides/prog_guide/dmadev.rst > index 2aa26d33b8..2b31dc904f 100644 > --- a/doc/guides/prog_guide/dmadev.rst > +++ b/doc/guides/prog_guide/dmadev.rst > @@ -1,8 +1,10 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright 2021 HiSilicon Limited > > -DMA Device Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +.. _direct_memory_access_dma: > + > +Direct Memory Access (DMA) Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The DMA library provides a DMA device framework for management and > provisioning > of hardware and software DMA poll mode drivers, defining generic API whi= ch > diff --git a/doc/guides/prog_guide/efd_lib.rst > b/doc/guides/prog_guide/efd_lib.rst > index 2b355ff2a6..4bee7237be 100644 > --- a/doc/guides/prog_guide/efd_lib.rst > +++ b/doc/guides/prog_guide/efd_lib.rst > @@ -3,8 +3,8 @@ > > .. _Efd_Library: > > -Elastic Flow Distributor Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D > +Elastic Flow Distributor (EFD) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Introduction > ------------ > diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst > b/doc/guides/prog_guide/env_abstraction_layer.rst > index 6debf54efb..5ce80a4496 100644 > --- a/doc/guides/prog_guide/env_abstraction_layer.rst > +++ b/doc/guides/prog_guide/env_abstraction_layer.rst > @@ -3,8 +3,8 @@ > > .. _Environment_Abstraction_Layer: > > -Environment Abstraction Layer > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D > +Environment Abstraction Layer (EAL) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The Environment Abstraction Layer (EAL) is responsible for gaining acces= s > to low-level resources such as hardware and memory space. > It provides a generic interface that hides the environment specifics fro= m > the applications and libraries. > diff --git a/doc/guides/prog_guide/ethdev/index.rst > b/doc/guides/prog_guide/ethdev/index.rst > new file mode 100644 > index 0000000000..c8e3b0d37b > --- /dev/null > +++ b/doc/guides/prog_guide/ethdev/index.rst > @@ -0,0 +1,12 @@ > +Ethernet Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +.. toctree:: > + :maxdepth: 1 > + > + poll_mode_drv > + rte_flow > + switch_representation > + traffic_metering_and_policing > + traffic_management > + qos_framework > diff --git a/doc/guides/prog_guide/poll_mode_drv.rst > b/doc/guides/prog_guide/ethdev/poll_mode_drv.rst > similarity index 100% > rename from doc/guides/prog_guide/poll_mode_drv.rst > rename to doc/guides/prog_guide/ethdev/poll_mode_drv.rst > diff --git a/doc/guides/prog_guide/qos_framework.rst > b/doc/guides/prog_guide/ethdev/qos_framework.rst > similarity index 100% > rename from doc/guides/prog_guide/qos_framework.rst > rename to doc/guides/prog_guide/ethdev/qos_framework.rst > diff --git a/doc/guides/prog_guide/rte_flow.rst > b/doc/guides/prog_guide/ethdev/rte_flow.rst > similarity index 100% > rename from doc/guides/prog_guide/rte_flow.rst > rename to doc/guides/prog_guide/ethdev/rte_flow.rst > diff --git a/doc/guides/prog_guide/switch_representation.rst > b/doc/guides/prog_guide/ethdev/switch_representation.rst > similarity index 100% > rename from doc/guides/prog_guide/switch_representation.rst > rename to doc/guides/prog_guide/ethdev/switch_representation.rst > diff --git a/doc/guides/prog_guide/traffic_management.rst > b/doc/guides/prog_guide/ethdev/traffic_management.rst > similarity index 100% > rename from doc/guides/prog_guide/traffic_management.rst > rename to doc/guides/prog_guide/ethdev/traffic_management.rst > diff --git a/doc/guides/prog_guide/traffic_metering_and_policing.rst > b/doc/guides/prog_guide/ethdev/traffic_metering_and_policing.rst > similarity index 100% > rename from doc/guides/prog_guide/traffic_metering_and_policing.rst > rename to doc/guides/prog_guide/ethdev/traffic_metering_and_policing.rst > diff --git a/doc/guides/prog_guide/event_crypto_adapter.rst > b/doc/guides/prog_guide/eventdev/event_crypto_adapter.rst > similarity index 100% > rename from doc/guides/prog_guide/event_crypto_adapter.rst > rename to doc/guides/prog_guide/eventdev/event_crypto_adapter.rst > diff --git a/doc/guides/prog_guide/event_ethernet_rx_adapter.rst > b/doc/guides/prog_guide/eventdev/event_ethernet_rx_adapter.rst > similarity index 100% > rename from doc/guides/prog_guide/event_ethernet_rx_adapter.rst > rename to doc/guides/prog_guide/eventdev/event_ethernet_rx_adapter.rst > diff --git a/doc/guides/prog_guide/event_ethernet_tx_adapter.rst > b/doc/guides/prog_guide/eventdev/event_ethernet_tx_adapter.rst > similarity index 100% > rename from doc/guides/prog_guide/event_ethernet_tx_adapter.rst > rename to doc/guides/prog_guide/eventdev/event_ethernet_tx_adapter.rst > diff --git a/doc/guides/prog_guide/event_timer_adapter.rst > b/doc/guides/prog_guide/eventdev/event_timer_adapter.rst > similarity index 100% > rename from doc/guides/prog_guide/event_timer_adapter.rst > rename to doc/guides/prog_guide/eventdev/event_timer_adapter.rst > diff --git a/doc/guides/prog_guide/eventdev.rst > b/doc/guides/prog_guide/eventdev/eventdev.rst > similarity index 99% > rename from doc/guides/prog_guide/eventdev.rst > rename to doc/guides/prog_guide/eventdev/eventdev.rst > index 2c83176846..211fcaeb9f 100644 > --- a/doc/guides/prog_guide/eventdev.rst > +++ b/doc/guides/prog_guide/eventdev/eventdev.rst > @@ -169,7 +169,7 @@ walk-through: > > .. _figure_eventdev-usage1: > > -.. figure:: img/eventdev_usage.* > +.. figure:: ../img/eventdev_usage.* > > Sample eventdev usage, with RX, two atomic stages and a single-link t= o > TX. > > diff --git a/doc/guides/prog_guide/eventdev/index.rst > b/doc/guides/prog_guide/eventdev/index.rst > new file mode 100644 > index 0000000000..e0e3f4328d > --- /dev/null > +++ b/doc/guides/prog_guide/eventdev/index.rst > @@ -0,0 +1,11 @@ > +Event Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +.. toctree:: > + :maxdepth: 1 > + > + eventdev > + event_ethernet_rx_adapter > + event_ethernet_tx_adapter > + event_timer_adapter > + event_crypto_adapter > diff --git a/doc/guides/prog_guide/fib_lib.rst > b/doc/guides/prog_guide/fib_lib.rst > index 970a433d34..a81da2d491 100644 > --- a/doc/guides/prog_guide/fib_lib.rst > +++ b/doc/guides/prog_guide/fib_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2021 Intel Corporation. > > -FIB Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Forwarding Information Base (FIB) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The FIB library provides a fast Longest Prefix Match (LPM) search for > 32-bit > keys or 128-bit for IPv6. It can be used in a variety of applications, > diff --git a/doc/guides/prog_guide/generic_receive_offload_lib.rst > b/doc/guides/prog_guide/generic_receive_offload_lib.rst > index 6d176947e4..f2b5ff9eed 100644 > --- a/doc/guides/prog_guide/generic_receive_offload_lib.rst > +++ b/doc/guides/prog_guide/generic_receive_offload_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2017 Intel Corporation. > > -Generic Receive Offload Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D > +Generic Receive Offload (GRO) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Generic Receive Offload (GRO) is a widely used SW-based offloading > technique to reduce per-packet processing overheads. By reassembling > diff --git a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst > b/doc/guides/prog_guide/generic_segmentation_offload_lib.rst > index e605b86376..97b906aee1 100644 > --- a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst > +++ b/doc/guides/prog_guide/generic_segmentation_offload_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2017 Intel Corporation. > > -Generic Segmentation Offload Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Generic Segmentation Offload (GSO) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Overview > -------- > diff --git a/doc/guides/prog_guide/gpudev.rst > b/doc/guides/prog_guide/gpudev.rst > index c6ae7191c8..de246d2a4c 100644 > --- a/doc/guides/prog_guide/gpudev.rst > +++ b/doc/guides/prog_guide/gpudev.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright (c) 2021 NVIDIA Corporation & Affiliates > > -General-Purpose Graphics Processing Unit Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +General-Purpose Graphics Processing Unit (GPU) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D > > When mixing networking activity with task processing on a GPU device, > there may be the need to put in communication the CPU with the device > diff --git a/doc/guides/prog_guide/index.rst > b/doc/guides/prog_guide/index.rst > index 52a6d9e7aa..6fcf304c68 100644 > --- a/doc/guides/prog_guide/index.rst > +++ b/doc/guides/prog_guide/index.rst > @@ -4,28 +4,67 @@ > Programmer's Guide > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > +Foundation Principles > +--------------------- > + > .. toctree:: > - :maxdepth: 3 > - :numbered: > + :maxdepth: 1 > > intro > overview > source_org > - env_abstraction_layer > - log_lib > - service_cores > - trace_lib > - rcu_lib > - ring_lib > - stack_lib > + glossary > + > +Memory Management > +----------------- > + > +.. toctree:: > + :maxdepth: 1 > + > mempool_lib > mbuf_lib > - poll_mode_drv > - rte_flow > - switch_representation > - traffic_metering_and_policing > - traffic_management > - bbdev > + multi_proc_support > + > +CPU Management > +-------------- > + > +.. toctree:: > + :maxdepth: 1 > + > + env_abstraction_layer > + power_man > + thread_safety > + service_cores > + > +CPU Packet Processing > +--------------------- > + > +.. toctree:: > + :maxdepth: 1 > + > + lpm_lib > + lpm6_lib > + rib_lib > + fib_lib > + packet_classif_access_ctrl > + packet_distrib_lib > + efd_lib > + reorder_lib > + ip_fragment_reassembly_lib > + generic_receive_offload_lib > + generic_segmentation_offload_lib > + toeplitz_hash_lib > + hash_lib > + member_lib > + > +Device Libraries > +---------------- > + > +.. toctree:: > + :maxdepth: 1 > + > + ethdev/index > + vhost_lib > cryptodev_lib > compressdev > regexdev > @@ -35,46 +74,62 @@ Programmer's Guide > rte_security > rawdev > link_bonding_poll_mode_drv_lib > + bbdev > + eventdev/index > + > +Utility Libraries > +----------------- > + > +.. toctree:: > + :maxdepth: 1 > + > timer_lib > - hash_lib > - toeplitz_hash_lib > - efd_lib > - member_lib > - lpm_lib > - lpm6_lib > - fib_lib > - rib_lib > - packet_distrib_lib > - reorder_lib > - ip_fragment_reassembly_lib > - generic_receive_offload_lib > - generic_segmentation_offload_lib > - ipsec_lib > - pdcp_lib > - pcapng_lib > - pdump_lib > - multi_proc_support > - thread_safety_dpdk_functions > - eventdev > - event_ethernet_rx_adapter > - event_ethernet_tx_adapter > - event_timer_adapter > - event_crypto_adapter > - qos_framework > - power_man > - packet_classif_access_ctrl > - packet_framework > - vhost_lib > + rcu_lib > + ring_lib > + stack_lib > metrics_lib > telemetry_lib > + pdump_lib > + pcapng_lib > bpf_lib > + trace_lib > + > +Protocol Processing Libraries > +----------------------------- > + > +.. toctree:: > + :maxdepth: 1 > + > + pdcp_lib > + ipsec_lib > + > +High-Level Libraries > +-------------------- > + > +.. toctree:: > + :maxdepth: 1 > + > + packet_framework > graph_lib > + > +Howto Guides > +------------- > + > +.. toctree:: > + :maxdepth: 1 > + > build-sdk-meson > meson_ut > build_app > + > +Tips & Tricks > +------------- > + > +.. toctree:: > + :maxdepth: 1 > + > perf_opt_guidelines > writing_efficient_code > lto > profile_app > asan > - glossary > diff --git a/doc/guides/prog_guide/lpm6_lib.rst > b/doc/guides/prog_guide/lpm6_lib.rst > index 8425d14805..2c3eb10857 100644 > --- a/doc/guides/prog_guide/lpm6_lib.rst > +++ b/doc/guides/prog_guide/lpm6_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2010-2014 Intel Corporation. > > -LPM6 Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Longest Prefix Match 6 (LPM6) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The LPM6 (LPM for IPv6) library component implements the Longest Prefix > Match (LPM) table search method for 128-bit keys > that is typically used to find the best match route in IPv6 forwarding > applications. > diff --git a/doc/guides/prog_guide/lpm_lib.rst > b/doc/guides/prog_guide/lpm_lib.rst > index 03945904b3..191fb8d81b 100644 > --- a/doc/guides/prog_guide/lpm_lib.rst > +++ b/doc/guides/prog_guide/lpm_lib.rst > @@ -3,8 +3,8 @@ > > .. _LPM_Library: > > -LPM Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Longest Prefix Match (LPM) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The DPDK LPM library component implements the Longest Prefix Match (LPM) > table search method for 32-bit keys > that is typically used to find the best route match in IP forwarding > applications. > diff --git a/doc/guides/prog_guide/mbuf_lib.rst > b/doc/guides/prog_guide/mbuf_lib.rst > index 049357c755..50fbd99923 100644 > --- a/doc/guides/prog_guide/mbuf_lib.rst > +++ b/doc/guides/prog_guide/mbuf_lib.rst > @@ -3,10 +3,10 @@ > > .. _Mbuf_Library: > > -Mbuf Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Packet (Mbuf) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > -The mbuf library provides the ability to allocate and free buffers (mbuf= s) > +The Packet (MBuf) library provides the ability to allocate and free > buffers (mbufs) > that may be used by the DPDK application to store message buffers. > The message buffers are stored in a mempool, using the :ref:`Mempool > Library `. > > diff --git a/doc/guides/prog_guide/mempool_lib.rst > b/doc/guides/prog_guide/mempool_lib.rst > index 4db577fe18..8769505d5d 100644 > --- a/doc/guides/prog_guide/mempool_lib.rst > +++ b/doc/guides/prog_guide/mempool_lib.rst > @@ -3,8 +3,8 @@ > > .. _Mempool_Library: > > -Mempool Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Memory Pool Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > A memory pool is an allocator of a fixed-sized object. > In the DPDK, it is identified by name and uses a mempool handler to stor= e > free objects. > diff --git a/doc/guides/prog_guide/mldev.rst > b/doc/guides/prog_guide/mldev.rst > index 102fbda71c..f9109a6a22 100644 > --- a/doc/guides/prog_guide/mldev.rst > +++ b/doc/guides/prog_guide/mldev.rst > @@ -1,10 +1,10 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright (c) 2022 Marvell. > > -Machine Learning Device Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D > +Machine Learning (ML) Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > -The MLDEV library provides a Machine Learning device framework for the > management and > +The Machine Learning (ML) Device library provides a Machine Learning > device framework for the management and > provisioning of hardware and software ML poll mode drivers, > defining an API which support a number of ML operations > including device handling and inference processing. > diff --git a/doc/guides/prog_guide/packet_classif_access_ctrl.rst > b/doc/guides/prog_guide/packet_classif_access_ctrl.rst > index 1811db4618..c8844d0616 100644 > --- a/doc/guides/prog_guide/packet_classif_access_ctrl.rst > +++ b/doc/guides/prog_guide/packet_classif_access_ctrl.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2010-2015 Intel Corporation. > > -Packet Classification and Access Control > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Packet Classification and Access Control (ACL) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D > > The DPDK provides an Access Control library that gives the ability > to classify an input packet based on a set of classification rules. > diff --git a/doc/guides/prog_guide/packet_framework.rst > b/doc/guides/prog_guide/packet_framework.rst > index ebc69d8c3e..9b8896aa74 100644 > --- a/doc/guides/prog_guide/packet_framework.rst > +++ b/doc/guides/prog_guide/packet_framework.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2010-2014 Intel Corporation. > > -Packet Framework > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Packet Framework Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Design Objectives > ----------------- > diff --git a/doc/guides/prog_guide/rawdev.rst > b/doc/guides/prog_guide/rawdev.rst > index 488e0a7ef6..f8aa3856d7 100644 > --- a/doc/guides/prog_guide/rawdev.rst > +++ b/doc/guides/prog_guide/rawdev.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright 2018 NXP > > -Rawdevice Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Raw Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Introduction > ------------ > diff --git a/doc/guides/prog_guide/regexdev.rst > b/doc/guides/prog_guide/regexdev.rst > index 93229fa743..3bf3b154b4 100644 > --- a/doc/guides/prog_guide/regexdev.rst > +++ b/doc/guides/prog_guide/regexdev.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright 2020 Mellanox Technologies, Ltd > > -RegEx Device Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Regular Expression (RegEx) Device Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The RegEx library provides a RegEx device framework for management and > provisioning of hardware and software RegEx poll mode drivers, defining > generic > diff --git a/doc/guides/prog_guide/rib_lib.rst > b/doc/guides/prog_guide/rib_lib.rst > index 53ca3518a0..40b7de3f1d 100644 > --- a/doc/guides/prog_guide/rib_lib.rst > +++ b/doc/guides/prog_guide/rib_lib.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2021 Intel Corporation. > > -RIB Library > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > +Routing Information Base (RIB) Library > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The Routing Information Base (RIB) library provides a data store for > routing information. > This library is intended for use in control or management plane > applications. > diff --git a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst > b/doc/guides/prog_guide/thread_safety.rst > similarity index 98% > rename from doc/guides/prog_guide/thread_safety_dpdk_functions.rst > rename to doc/guides/prog_guide/thread_safety.rst > index 5618e25e47..f7cda8bb32 100644 > --- a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst > +++ b/doc/guides/prog_guide/thread_safety.rst > @@ -1,8 +1,8 @@ > .. SPDX-License-Identifier: BSD-3-Clause > Copyright(c) 2010-2014 Intel Corporation. > > -Thread Safety of DPDK Functions > -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D > +Thread Safety > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > The DPDK is comprised of several libraries. > Some of the functions in these libraries can be safely called from > multiple threads simultaneously, while others cannot. > -- > 2.41.0.windows.1 > > --000000000000986383060c017297 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Signed-off-by: David Young <dave@youngcopy.com>

Thanks!
David Young
Professio= nal Copywriter/Technical Writer
Young Copy
+1 (678) 500-95= 50


On T= hu, Dec 7, 2023 at 9:11=E2=80=AFPM David Young <dave@youngcopy.com> wrote:
---
=C2=A0doc/guides/prog_guide/bpf_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/dmadev.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 |=C2=A0 =C2=A06 +-
=C2=A0doc/guides/prog_guide/efd_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0.../prog_guide/env_abstraction_layer.rst=C2=A0 =C2=A0 =C2=A0 |=C2=A0 = =C2=A04 +-
=C2=A0doc/guides/prog_guide/ethdev/index.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 |= =C2=A0 12 ++
=C2=A0.../prog_guide/{ =3D> ethdev}/poll_mode_drv.rst |=C2=A0 =C2=A00 =C2=A0.../prog_guide/{ =3D> ethdev}/qos_framework.rst |=C2=A0 =C2=A00 =C2=A0.../prog_guide/{ =3D> ethdev}/rte_flow.rst=C2=A0 =C2=A0 =C2=A0 |= =C2=A0 =C2=A00
=C2=A0.../{ =3D> ethdev}/switch_representation.rst=C2=A0 =C2=A0 |=C2=A0 = =C2=A00
=C2=A0.../{ =3D> ethdev}/traffic_management.rst=C2=A0 =C2=A0 =C2=A0 =C2= =A0|=C2=A0 =C2=A00
=C2=A0.../traffic_metering_and_policing.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0|=C2=A0 =C2=A00
=C2=A0.../{ =3D> eventdev}/event_crypto_adapter.rst=C2=A0 =C2=A0|=C2=A0 = =C2=A00
=C2=A0.../event_ethernet_rx_adapter.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A00
=C2=A0.../event_ethernet_tx_adapter.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A00
=C2=A0.../{ =3D> eventdev}/event_timer_adapter.rst=C2=A0 =C2=A0 |=C2=A0 = =C2=A00
=C2=A0.../prog_guide/{ =3D> eventdev}/eventdev.rst=C2=A0 =C2=A0 |=C2=A0 = =C2=A02 +-
=C2=A0doc/guides/prog_guide/eventdev/index.rst=C2=A0 =C2=A0 =C2=A0 |=C2=A0 = 11 ++
=C2=A0doc/guides/prog_guide/fib_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0.../generic_receive_offload_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0.../generic_segmentation_offload_lib.rst=C2=A0 =C2=A0 =C2=A0 |=C2=A0 = =C2=A04 +-
=C2=A0doc/guides/prog_guide/gpudev.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 |=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/index.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0| 145 ++++++++++++------
=C2=A0doc/guides/prog_guide/lpm6_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 |=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/lpm_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/mbuf_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 |=C2=A0 =C2=A06 +-
=C2=A0doc/guides/prog_guide/mempool_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0|=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/mldev.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 =C2=A0|=C2=A0 =C2=A06 +-
=C2=A0.../prog_guide/packet_classif_access_ctrl.rst |=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/packet_framework.rst=C2=A0 =C2=A0 |=C2=A0 =C2= =A04 +-
=C2=A0doc/guides/prog_guide/rawdev.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 |=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/regexdev.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 |=C2=A0 =C2=A04 +-
=C2=A0doc/guides/prog_guide/rib_lib.rst=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0|=C2=A0 =C2=A04 +-
=C2=A0...y_dpdk_functions.rst =3D> thread_safety.rst} |=C2=A0 =C2=A04 +-=
=C2=A033 files changed, 166 insertions(+), 86 deletions(-)
=C2=A0create mode 100644 doc/guides/prog_guide/ethdev/index.rst
=C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/poll_mode_drv.rst (100= %)
=C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/qos_framework.rst (100= %)
=C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/rte_flow.rst (100%) =C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/switch_representation.= rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/traffic_management.rst= (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> ethdev}/traffic_metering_and_p= olicing.rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> eventdev}/event_crypto_adapter= .rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> eventdev}/event_ethernet_rx_ad= apter.rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> eventdev}/event_ethernet_tx_ad= apter.rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> eventdev}/event_timer_adapter.= rst (100%)
=C2=A0rename doc/guides/prog_guide/{ =3D> eventdev}/eventdev.rst (99%) =C2=A0create mode 100644 doc/guides/prog_guide/eventdev/index.rst
=C2=A0rename doc/guides/prog_guide/{thread_safety_dpdk_functions.rst =3D>= ; thread_safety.rst} (98%)

diff --git a/doc/guides/prog_guide/bpf_lib.rst b/doc/guides/prog_guide/bpf_= lib.rst
index 1cf2d59429..8c820328b9 100644
--- a/doc/guides/prog_guide/bpf_lib.rst
+++ b/doc/guides/prog_guide/bpf_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2018 Intel Corporation.

-Berkeley Packet Filter Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D
+Berkeley Packet Filter (BPF) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The DPDK provides an BPF library that gives the ability
=C2=A0to load and execute Enhanced Berkeley Packet Filter (eBPF) bytecode w= ithin
diff --git a/doc/guides/prog_guide/dmadev.rst b/doc/guides/prog_guide/dmade= v.rst
index 2aa26d33b8..2b31dc904f 100644
--- a/doc/guides/prog_guide/dmadev.rst
+++ b/doc/guides/prog_guide/dmadev.rst
@@ -1,8 +1,10 @@
=C2=A0.. SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 Copyright 2021 HiSilicon Limited

-DMA Device Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+.. _direct_memory_access_dma:
+
+Direct Memory Access (DMA) Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The DMA library provides a DMA device framework for management and pr= ovisioning
=C2=A0of hardware and software DMA poll mode drivers, defining generic API = which
diff --git a/doc/guides/prog_guide/efd_lib.rst b/doc/guides/prog_guide/efd_= lib.rst
index 2b355ff2a6..4bee7237be 100644
--- a/doc/guides/prog_guide/efd_lib.rst
+++ b/doc/guides/prog_guide/efd_lib.rst
@@ -3,8 +3,8 @@

=C2=A0.. _Efd_Library:

-Elastic Flow Distributor Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D
+Elastic Flow Distributor (EFD) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0Introduction
=C2=A0------------
diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/p= rog_guide/env_abstraction_layer.rst
index 6debf54efb..5ce80a4496 100644
--- a/doc/guides/prog_guide/env_abstraction_layer.rst
+++ b/doc/guides/prog_guide/env_abstraction_layer.rst
@@ -3,8 +3,8 @@

=C2=A0.. _Environment_Abstraction_Layer:

-Environment Abstraction Layer
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D
+Environment Abstraction Layer (EAL) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The Environment Abstraction Layer (EAL) is responsible for gaining ac= cess to low-level resources such as hardware and memory space.
=C2=A0It provides a generic interface that hides the environment specifics = from the applications and libraries.
diff --git a/doc/guides/prog_guide/ethdev/index.rst b/doc/guides/prog_guide= /ethdev/index.rst
new file mode 100644
index 0000000000..c8e3b0d37b
--- /dev/null
+++ b/doc/guides/prog_guide/ethdev/index.rst
@@ -0,0 +1,12 @@
+Ethernet Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 poll_mode_drv
+=C2=A0 =C2=A0 rte_flow
+=C2=A0 =C2=A0 switch_representation
+=C2=A0 =C2=A0 traffic_metering_and_policing
+=C2=A0 =C2=A0 traffic_management
+=C2=A0 =C2=A0 qos_framework
diff --git a/doc/guides/prog_guide/poll_mode_drv.rst b/doc/guides/prog_guid= e/ethdev/poll_mode_drv.rst
similarity index 100%
rename from doc/guides/prog_guide/poll_mode_drv.rst
rename to doc/guides/prog_guide/ethdev/poll_mode_drv.rst
diff --git a/doc/guides/prog_guide/qos_framework.rst b/doc/guides/prog_guid= e/ethdev/qos_framework.rst
similarity index 100%
rename from doc/guides/prog_guide/qos_framework.rst
rename to doc/guides/prog_guide/ethdev/qos_framework.rst
diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/eth= dev/rte_flow.rst
similarity index 100%
rename from doc/guides/prog_guide/rte_flow.rst
rename to doc/guides/prog_guide/ethdev/rte_flow.rst
diff --git a/doc/guides/prog_guide/switch_representation.rst b/doc/guides/p= rog_guide/ethdev/switch_representation.rst
similarity index 100%
rename from doc/guides/prog_guide/switch_representation.rst
rename to doc/guides/prog_guide/ethdev/switch_representation.rst
diff --git a/doc/guides/prog_guide/traffic_management.rst b/doc/guides/prog= _guide/ethdev/traffic_management.rst
similarity index 100%
rename from doc/guides/prog_guide/traffic_management.rst
rename to doc/guides/prog_guide/ethdev/traffic_management.rst
diff --git a/doc/guides/prog_guide/traffic_metering_and_policing.rst b/doc/= guides/prog_guide/ethdev/traffic_metering_and_policing.rst
similarity index 100%
rename from doc/guides/prog_guide/traffic_metering_and_policing.rst
rename to doc/guides/prog_guide/ethdev/traffic_metering_and_policing.rst diff --git a/doc/guides/prog_guide/event_crypto_adapter.rst b/doc/guides/pr= og_guide/eventdev/event_crypto_adapter.rst
similarity index 100%
rename from doc/guides/prog_guide/event_crypto_adapter.rst
rename to doc/guides/prog_guide/eventdev/event_crypto_adapter.rst
diff --git a/doc/guides/prog_guide/event_ethernet_rx_adapter.rst b/doc/guid= es/prog_guide/eventdev/event_ethernet_rx_adapter.rst
similarity index 100%
rename from doc/guides/prog_guide/event_ethernet_rx_adapter.rst
rename to doc/guides/prog_guide/eventdev/event_ethernet_rx_adapter.rst
diff --git a/doc/guides/prog_guide/event_ethernet_tx_adapter.rst b/doc/guid= es/prog_guide/eventdev/event_ethernet_tx_adapter.rst
similarity index 100%
rename from doc/guides/prog_guide/event_ethernet_tx_adapter.rst
rename to doc/guides/prog_guide/eventdev/event_ethernet_tx_adapter.rst
diff --git a/doc/guides/prog_guide/event_timer_adapter.rst b/doc/guides/pro= g_guide/eventdev/event_timer_adapter.rst
similarity index 100%
rename from doc/guides/prog_guide/event_timer_adapter.rst
rename to doc/guides/prog_guide/eventdev/event_timer_adapter.rst
diff --git a/doc/guides/prog_guide/eventdev.rst b/doc/guides/prog_guide/eve= ntdev/eventdev.rst
similarity index 99%
rename from doc/guides/prog_guide/eventdev.rst
rename to doc/guides/prog_guide/eventdev/eventdev.rst
index 2c83176846..211fcaeb9f 100644
--- a/doc/guides/prog_guide/eventdev.rst
+++ b/doc/guides/prog_guide/eventdev/eventdev.rst
@@ -169,7 +169,7 @@ walk-through:

=C2=A0.. _figure_eventdev-usage1:

-.. figure:: img/eventdev_usage.*
+.. figure:: ../img/eventdev_usage.*

=C2=A0 =C2=A0 Sample eventdev usage, with RX, two atomic stages and a singl= e-link to TX.

diff --git a/doc/guides/prog_guide/eventdev/index.rst b/doc/guides/prog_gui= de/eventdev/index.rst
new file mode 100644
index 0000000000..e0e3f4328d
--- /dev/null
+++ b/doc/guides/prog_guide/eventdev/index.rst
@@ -0,0 +1,11 @@
+Event Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 eventdev
+=C2=A0 =C2=A0 event_ethernet_rx_adapter
+=C2=A0 =C2=A0 event_ethernet_tx_adapter
+=C2=A0 =C2=A0 event_timer_adapter
+=C2=A0 =C2=A0 event_crypto_adapter
diff --git a/doc/guides/prog_guide/fib_lib.rst b/doc/guides/prog_guide/fib_= lib.rst
index 970a433d34..a81da2d491 100644
--- a/doc/guides/prog_guide/fib_lib.rst
+++ b/doc/guides/prog_guide/fib_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2021 Intel Corporation.

-FIB Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Forwarding Information Base (FIB) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The FIB library provides a fast Longest Prefix Match (LPM) search for= 32-bit
=C2=A0keys or 128-bit for IPv6. It can be used in a variety of applications= ,
diff --git a/doc/guides/prog_guide/generic_receive_offload_lib.rst b/doc/gu= ides/prog_guide/generic_receive_offload_lib.rst
index 6d176947e4..f2b5ff9eed 100644
--- a/doc/guides/prog_guide/generic_receive_offload_lib.rst
+++ b/doc/guides/prog_guide/generic_receive_offload_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2017 Intel Corporation.

-Generic Receive Offload Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D
+Generic Receive Offload (GRO) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0Generic Receive Offload (GRO) is a widely used SW-based offloading =C2=A0technique to reduce per-packet processing overheads. By reassembling<= br> diff --git a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst b/d= oc/guides/prog_guide/generic_segmentation_offload_lib.rst
index e605b86376..97b906aee1 100644
--- a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst
+++ b/doc/guides/prog_guide/generic_segmentation_offload_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2017 Intel Corporation.

-Generic Segmentation Offload Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Generic Segmentation Offload (GSO) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0Overview
=C2=A0--------
diff --git a/doc/guides/prog_guide/gpudev.rst b/doc/guides/prog_guide/gpude= v.rst
index c6ae7191c8..de246d2a4c 100644
--- a/doc/guides/prog_guide/gpudev.rst
+++ b/doc/guides/prog_guide/gpudev.rst
@@ -1,8 +1,8 @@
=C2=A0.. SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 Copyright (c) 2021 NVIDIA Corporation & Affiliates

-General-Purpose Graphics Processing Unit Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +General-Purpose Graphics Processing Unit (GPU) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D

=C2=A0When mixing networking activity with task processing on a GPU device,=
=C2=A0there may be the need to put in communication the CPU with the device=
diff --git a/doc/guides/prog_guide/index.rst b/doc/guides/prog_guide/index.= rst
index 52a6d9e7aa..6fcf304c68 100644
--- a/doc/guides/prog_guide/index.rst
+++ b/doc/guides/prog_guide/index.rst
@@ -4,28 +4,67 @@
=C2=A0Programmer's Guide
=C2=A0=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

+Foundation Principles
+---------------------
+
=C2=A0.. toctree::
-=C2=A0 =C2=A0 :maxdepth: 3
-=C2=A0 =C2=A0 :numbered:
+=C2=A0 =C2=A0 :maxdepth: 1

=C2=A0 =C2=A0 =C2=A0intro
=C2=A0 =C2=A0 =C2=A0overview
=C2=A0 =C2=A0 =C2=A0source_org
-=C2=A0 =C2=A0 env_abstraction_layer
-=C2=A0 =C2=A0 log_lib
-=C2=A0 =C2=A0 service_cores
-=C2=A0 =C2=A0 trace_lib
-=C2=A0 =C2=A0 rcu_lib
-=C2=A0 =C2=A0 ring_lib
-=C2=A0 =C2=A0 stack_lib
+=C2=A0 =C2=A0 glossary=C2=A0 =C2=A0
+
+Memory Management
+-----------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
=C2=A0 =C2=A0 =C2=A0mempool_lib
=C2=A0 =C2=A0 =C2=A0mbuf_lib
-=C2=A0 =C2=A0 poll_mode_drv
-=C2=A0 =C2=A0 rte_flow
-=C2=A0 =C2=A0 switch_representation
-=C2=A0 =C2=A0 traffic_metering_and_policing
-=C2=A0 =C2=A0 traffic_management
-=C2=A0 =C2=A0 bbdev
+=C2=A0 =C2=A0 multi_proc_support
+
+CPU Management
+--------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 env_abstraction_layer
+=C2=A0 =C2=A0 power_man
+=C2=A0 =C2=A0 thread_safety
+=C2=A0 =C2=A0 service_cores
+
+CPU Packet Processing
+---------------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 lpm_lib
+=C2=A0 =C2=A0 lpm6_lib
+=C2=A0 =C2=A0 rib_lib
+=C2=A0 =C2=A0 fib_lib
+=C2=A0 =C2=A0 packet_classif_access_ctrl
+=C2=A0 =C2=A0 packet_distrib_lib
+=C2=A0 =C2=A0 efd_lib
+=C2=A0 =C2=A0 reorder_lib
+=C2=A0 =C2=A0 ip_fragment_reassembly_lib
+=C2=A0 =C2=A0 generic_receive_offload_lib
+=C2=A0 =C2=A0 generic_segmentation_offload_lib
+=C2=A0 =C2=A0 toeplitz_hash_lib
+=C2=A0 =C2=A0 hash_lib
+=C2=A0 =C2=A0 member_lib
+
+Device Libraries
+----------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 ethdev/index
+=C2=A0 =C2=A0 vhost_lib
=C2=A0 =C2=A0 =C2=A0cryptodev_lib
=C2=A0 =C2=A0 =C2=A0compressdev
=C2=A0 =C2=A0 =C2=A0regexdev
@@ -35,46 +74,62 @@ Programmer's Guide
=C2=A0 =C2=A0 =C2=A0rte_security
=C2=A0 =C2=A0 =C2=A0rawdev
=C2=A0 =C2=A0 =C2=A0link_bonding_poll_mode_drv_lib
+=C2=A0 =C2=A0 bbdev
+=C2=A0 =C2=A0 eventdev/index
+
+Utility Libraries
+-----------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
=C2=A0 =C2=A0 =C2=A0timer_lib
-=C2=A0 =C2=A0 hash_lib
-=C2=A0 =C2=A0 toeplitz_hash_lib
-=C2=A0 =C2=A0 efd_lib
-=C2=A0 =C2=A0 member_lib
-=C2=A0 =C2=A0 lpm_lib
-=C2=A0 =C2=A0 lpm6_lib
-=C2=A0 =C2=A0 fib_lib
-=C2=A0 =C2=A0 rib_lib
-=C2=A0 =C2=A0 packet_distrib_lib
-=C2=A0 =C2=A0 reorder_lib
-=C2=A0 =C2=A0 ip_fragment_reassembly_lib
-=C2=A0 =C2=A0 generic_receive_offload_lib
-=C2=A0 =C2=A0 generic_segmentation_offload_lib
-=C2=A0 =C2=A0 ipsec_lib
-=C2=A0 =C2=A0 pdcp_lib
-=C2=A0 =C2=A0 pcapng_lib
-=C2=A0 =C2=A0 pdump_lib
-=C2=A0 =C2=A0 multi_proc_support
-=C2=A0 =C2=A0 thread_safety_dpdk_functions
-=C2=A0 =C2=A0 eventdev
-=C2=A0 =C2=A0 event_ethernet_rx_adapter
-=C2=A0 =C2=A0 event_ethernet_tx_adapter
-=C2=A0 =C2=A0 event_timer_adapter
-=C2=A0 =C2=A0 event_crypto_adapter
-=C2=A0 =C2=A0 qos_framework
-=C2=A0 =C2=A0 power_man
-=C2=A0 =C2=A0 packet_classif_access_ctrl
-=C2=A0 =C2=A0 packet_framework
-=C2=A0 =C2=A0 vhost_lib
+=C2=A0 =C2=A0 rcu_lib
+=C2=A0 =C2=A0 ring_lib
+=C2=A0 =C2=A0 stack_lib
=C2=A0 =C2=A0 =C2=A0metrics_lib
=C2=A0 =C2=A0 =C2=A0telemetry_lib
+=C2=A0 =C2=A0 pdump_lib
+=C2=A0 =C2=A0 pcapng_lib
=C2=A0 =C2=A0 =C2=A0bpf_lib
+=C2=A0 =C2=A0 trace_lib
+
+Protocol Processing Libraries
+-----------------------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 pdcp_lib
+=C2=A0 =C2=A0 ipsec_lib
+
+High-Level Libraries
+--------------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
+=C2=A0 =C2=A0 packet_framework
=C2=A0 =C2=A0 =C2=A0graph_lib
+
+Howto Guides
+-------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
=C2=A0 =C2=A0 =C2=A0build-sdk-meson
=C2=A0 =C2=A0 =C2=A0meson_ut
=C2=A0 =C2=A0 =C2=A0build_app
+
+Tips & Tricks
+-------------
+
+.. toctree::
+=C2=A0 =C2=A0 :maxdepth: 1
+
=C2=A0 =C2=A0 =C2=A0perf_opt_guidelines
=C2=A0 =C2=A0 =C2=A0writing_efficient_code
=C2=A0 =C2=A0 =C2=A0lto
=C2=A0 =C2=A0 =C2=A0profile_app
=C2=A0 =C2=A0 =C2=A0asan
-=C2=A0 =C2=A0 glossary
diff --git a/doc/guides/prog_guide/lpm6_lib.rst b/doc/guides/prog_guide/lpm= 6_lib.rst
index 8425d14805..2c3eb10857 100644
--- a/doc/guides/prog_guide/lpm6_lib.rst
+++ b/doc/guides/prog_guide/lpm6_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2010-2014 Intel Corporation.

-LPM6 Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Longest Prefix Match 6 (LPM6) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The LPM6 (LPM for IPv6) library component implements the Longest Pref= ix Match (LPM) table search method for 128-bit keys
=C2=A0that is typically used to find the best match route in IPv6 forwardin= g applications.
diff --git a/doc/guides/prog_guide/lpm_lib.rst b/doc/guides/prog_guide/lpm_= lib.rst
index 03945904b3..191fb8d81b 100644
--- a/doc/guides/prog_guide/lpm_lib.rst
+++ b/doc/guides/prog_guide/lpm_lib.rst
@@ -3,8 +3,8 @@

=C2=A0.. _LPM_Library:

-LPM Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Longest Prefix Match (LPM) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The DPDK LPM library component implements the Longest Prefix Match (L= PM) table search method for 32-bit keys
=C2=A0that is typically used to find the best route match in IP forwarding = applications.
diff --git a/doc/guides/prog_guide/mbuf_lib.rst b/doc/guides/prog_guide/mbu= f_lib.rst
index 049357c755..50fbd99923 100644
--- a/doc/guides/prog_guide/mbuf_lib.rst
+++ b/doc/guides/prog_guide/mbuf_lib.rst
@@ -3,10 +3,10 @@

=C2=A0.. _Mbuf_Library:

-Mbuf Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Packet (Mbuf) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

-The mbuf library provides the ability to allocate and free buffers (mbufs)=
+The Packet (MBuf) library provides the ability to allocate and free buffer= s (mbufs)
=C2=A0that may be used by the DPDK application to store message buffers. =C2=A0The message buffers are stored in a mempool, using the :ref:`Mempool = Library <Mempool_Library>`.

diff --git a/doc/guides/prog_guide/mempool_lib.rst b/doc/guides/prog_guide/= mempool_lib.rst
index 4db577fe18..8769505d5d 100644
--- a/doc/guides/prog_guide/mempool_lib.rst
+++ b/doc/guides/prog_guide/mempool_lib.rst
@@ -3,8 +3,8 @@

=C2=A0.. _Mempool_Library:

-Mempool Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Memory Pool Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0A memory pool is an allocator of a fixed-sized object.
=C2=A0In the DPDK, it is identified by name and uses a mempool handler to s= tore free objects.
diff --git a/doc/guides/prog_guide/mldev.rst b/doc/guides/prog_guide/mldev.= rst
index 102fbda71c..f9109a6a22 100644
--- a/doc/guides/prog_guide/mldev.rst
+++ b/doc/guides/prog_guide/mldev.rst
@@ -1,10 +1,10 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright (c) 2022 Marvell.

-Machine Learning Device Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D
+Machine Learning (ML) Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

-The MLDEV library provides a Machine Learning device framework for the man= agement and
+The Machine Learning (ML) Device library provides a Machine Learning devic= e framework for the management and
=C2=A0provisioning of hardware and software ML poll mode drivers,
=C2=A0defining an API which support a number of ML operations
=C2=A0including device handling and inference processing.
diff --git a/doc/guides/prog_guide/packet_classif_access_ctrl.rst b/doc/gui= des/prog_guide/packet_classif_access_ctrl.rst
index 1811db4618..c8844d0616 100644
--- a/doc/guides/prog_guide/packet_classif_access_ctrl.rst
+++ b/doc/guides/prog_guide/packet_classif_access_ctrl.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2010-2015 Intel Corporation.

-Packet Classification and Access Control
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Packet Classification and Access Control (ACL) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D

=C2=A0The DPDK provides an Access Control library that gives the ability =C2=A0to classify an input packet based on a set of classification rules. diff --git a/doc/guides/prog_guide/packet_framework.rst b/doc/guides/prog_g= uide/packet_framework.rst
index ebc69d8c3e..9b8896aa74 100644
--- a/doc/guides/prog_guide/packet_framework.rst
+++ b/doc/guides/prog_guide/packet_framework.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2010-2014 Intel Corporation.

-Packet Framework
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Packet Framework Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
=C2=A0Design Objectives
=C2=A0-----------------
diff --git a/doc/guides/prog_guide/rawdev.rst b/doc/guides/prog_guide/rawde= v.rst
index 488e0a7ef6..f8aa3856d7 100644
--- a/doc/guides/prog_guide/rawdev.rst
+++ b/doc/guides/prog_guide/rawdev.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright 2018 NXP

-Rawdevice Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Raw Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0Introduction
=C2=A0------------
diff --git a/doc/guides/prog_guide/regexdev.rst b/doc/guides/prog_guide/reg= exdev.rst
index 93229fa743..3bf3b154b4 100644
--- a/doc/guides/prog_guide/regexdev.rst
+++ b/doc/guides/prog_guide/regexdev.rst
@@ -1,8 +1,8 @@
=C2=A0.. SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 Copyright 2020 Mellanox Technologies, Ltd

-RegEx Device Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Regular Expression (RegEx) Device Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The RegEx library provides a RegEx device framework for management an= d
=C2=A0provisioning of hardware and software RegEx poll mode drivers, defini= ng generic
diff --git a/doc/guides/prog_guide/rib_lib.rst b/doc/guides/prog_guide/rib_= lib.rst
index 53ca3518a0..40b7de3f1d 100644
--- a/doc/guides/prog_guide/rib_lib.rst
+++ b/doc/guides/prog_guide/rib_lib.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2021 Intel Corporation.

-RIB Library
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+Routing Information Base (RIB) Library
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The Routing Information Base (RIB) library provides a data store for = routing information.
=C2=A0This library is intended for use in control or management plane appli= cations.
diff --git a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst b/doc/g= uides/prog_guide/thread_safety.rst
similarity index 98%
rename from doc/guides/prog_guide/thread_safety_dpdk_functions.rst
rename to doc/guides/prog_guide/thread_safety.rst
index 5618e25e47..f7cda8bb32 100644
--- a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst
+++ b/doc/guides/prog_guide/thread_safety.rst
@@ -1,8 +1,8 @@
=C2=A0..=C2=A0 SPDX-License-Identifier: BSD-3-Clause
=C2=A0 =C2=A0 =C2=A0Copyright(c) 2010-2014 Intel Corporation.

-Thread Safety of DPDK Functions
-=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D
+Thread Safety
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

=C2=A0The DPDK is comprised of several libraries.
=C2=A0Some of the functions in these libraries can be safely called from mu= ltiple threads simultaneously, while others cannot.
--
2.41.0.windows.1

--000000000000986383060c017297--