From fc8744bb6ffe6d72d3c24be7ef923a39d159ec4d Mon Sep 17 00:00:00 2001
From: Randolph Sapp <rs@ti.com>
Date: Sat, 12 Jul 2025 12:52:59 -0500
Subject: [PATCH 1/2] fix(overview): remove incorrect ifconfig use

Remove the last of the incorrect usage of the ifconfig directive.
Replace these cumbersome tables with list-tables.

This is a little goofy due to old formatting. To keep in line with what
was previously here (and to prevent automatic numbering of these
tables), we must place the header in the first row and pad accordingly.

Signed-off-by: Randolph Sapp <rs@ti.com>
---
 ...or_SDK_Linux_Software_Developers_Guide.rst | 193 ++++++++----------
 1 file changed, 90 insertions(+), 103 deletions(-)

diff --git a/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst b/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
index 2bc4501e0..c81cd3488 100644
--- a/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
+++ b/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
@@ -8,123 +8,110 @@ suggestions at `E2E <https://e2e.ti.com/>`__.
 
 .. ifconfig:: CONFIG_sdk in ('SITARA')
 
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-    | **Processor SDK Linux**                                                                                                                                |
-    +========================================================================+===============================================================================+
-    | |___Getting Started Guide___|  <-- **Start Here**                      | |___How To Guides___|                                                         |
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-    | |___Supported Platforms and Versions___|                               | |___Building the SDK___|                                                      |
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-    | |___Directory Structure Overview___|                                   | |___GPLv3 Disclaimer___|                                                      |
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-    | |___Release Notes___|                                                  | |___Migration Guide___|                                                       |
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-    | |___Technical Support___|                                              | `Training <https://training.ti.com/processor-sdk-training-series>`__          |
-    +------------------------------------------------------------------------+-------------------------------------------------------------------------------+
-
-    .. |___Getting Started Guide___| replace:: :ref:`Getting Started Guide <overview-getting-started>`
-    .. |___Directory Structure Overview___| replace:: :ref:`Directory Structure Overview <overview-directory-structure>`
-    .. |___Building the SDK___| replace:: :ref:`Building the SDK with Yocto <overview-building-the-sdk>`
-    .. |___GPLv3 Disclaimer___| replace:: :ref:`GPLv3 Disclaimer <overview-gplv3-disclaimer>`
-    .. |___Technical Support___| replace:: :ref:`Technical Support <overview-technical-support>`
-    .. |___Supported Platforms and Versions___| replace:: :ref:`Supported Platforms and Versions <release-specific-supported-platforms-and-versions>`
-    .. |___Migration Guide___| replace:: :ref:`Migration Guide <release-specific-migration-guide>`
-    .. |___How To Guides___| replace:: :ref:`How To Guides <how-to-guides>`
-    .. |___Release Notes___| replace:: :ref:`Release Notes <Release-note-label>`
+   .. list-table::
+      :header-rows: 1
+
+      * - Processor SDK Linux
+        -
+      * - :ref:`Getting Started Guide <overview-getting-started>` <-- **Start Here**
+        - :ref:`How To Guides <how-to-guides>`
+      * - :ref:`Supported Platforms and Versions <release-specific-supported-platforms-and-versions>`
+        - :ref:`Building the SDK with Yocto <overview-building-the-sdk>`
+      * - :ref:`Directory Structure Overview <overview-directory-structure>`
+        - :ref:`GPLv3 Disclaimer <overview-gplv3-disclaimer>`
+      * - :ref:`Release Notes <Release-note-label>`
+        - :ref:`Migration Guide <release-specific-migration-guide>`
+      * - :ref:`Technical Support <overview-technical-support>`
+        - `Training <https://training.ti.com/processor-sdk-training-series>`__
 
 
 .. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
 
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-    |           **Processor SDK Linux**                                     |                                                                      |
-    +=======================================================================+======================================================================+
-    | |__Getting Started Guide__|  <-- **Start Here**                       | |__Directory Structure Overview__|                                   |
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-    | |__Release Notes__|                                                   | |__How To Guides__|                                                  |
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-    | |__Technical Support__|                                               | |__Building the SDK__|                                               |
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-    | |__Linux Software Stack__|                                            | |__GPLv3 Disclaimer__|                                               |
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-    | `Training <https://training.ti.com/processor-sdk-training-series>`__  |                                                                      |
-    +-----------------------------------------------------------------------+----------------------------------------------------------------------+
-
-    .. |__Getting Started Guide__| replace:: :ref:`Getting Started Guide <overview-getting-started>`
-    .. |__Directory Structure Overview__| replace:: :ref:`Directory Structure Overview <overview-directory-structure>`
-    .. |__Building the SDK__| replace:: :ref:`Building the SDK with Yocto <overview-building-the-sdk>`
-    .. |__GPLv3 Disclaimer__| replace:: :ref:`GPLv3 Disclaimer <overview-gplv3-disclaimer>`
-    .. |__Technical Support__| replace:: :ref:`Technical Support <overview-technical-support>`
-    .. |__Supported Platforms and Versions__| replace:: :ref:`Supported Platforms and Versions <release-specific-supported-platforms-and-versions>`
-    .. |__Linux Software Stack__| replace:: :ref:`Linux Software Stack <overview-software-stack>`
-    .. |__Migration Guide__| replace:: :ref:`Migration Guide <release-specific-migration-guide>`
-    .. |__How To Guides__| replace:: :ref:`How To Guides <how-to-guides>`
-    .. |__Release Notes__| replace:: :ref:`Release Notes <Release-note-label>`
+   .. list-table::
+      :header-rows: 1
+
+      * - Processor SDK Linux
+        -
+      * - :ref:`Getting Started Guide <overview-getting-started>` <-- **Start Here**
+        - :ref:`Directory Structure Overview <overview-directory-structure>`
+      * - :ref:`Release Notes <Release-note-label>`
+        - :ref:`How To Guides <how-to-guides>`
+      * - :ref:`Technical Support <overview-technical-support>`
+        - :ref:`Building the SDK with Yocto <overview-building-the-sdk>`
+      * - :ref:`Linux Software Stack <overview-software-stack>`
+        - :ref:`GPLv3 Disclaimer <overview-gplv3-disclaimer>`
+      * - `Training <https://training.ti.com/processor-sdk-training-series>`__
+        -
 
 
 .. ifconfig:: CONFIG_part_family in ('General_family')
 
-    +------------------+------------------------+----------------------------+----------------------------+
-    | **Foundational Components** (more information on each piece of the distribution)                    |
-    +==================+========================+============================+============================+
-    | |__U-Boot__|     | |__Boot Monitor__|     | |__Kernel__|               | |__Filesystem__|           |
-    +------------------+------------------------+----------------------------+----------------------------+
-    | |__Tools__|      | |__OpenCL__|           | |__OpenCV__|               | |__Graphics & Display__|   |
-    +------------------+------------------------+----------------------------+----------------------------+
-    | |__Multimedia__| | |__Examples & Demos__| | |__PRU Subsystem__|        | |__Virtualization__|       |
-    +------------------+------------------------+----------------------------+----------------------------+
-    | |__IPC__|        | |__OpenVX__|           | |__CMEM__|                 | |__Machine Learning__|     |
-    +------------------+------------------------+----------------------------+----------------------------+
-    | |__ATF__|        | |__OPTEE__|            |                            |                            |
-    +------------------+------------------------+----------------------------+----------------------------+
-
-    .. |__Boot Monitor__| replace:: :ref:`Boot Monitor  <foundational-components-boot-monitor>`
-    .. |__OpenCL__| replace:: `OpenCL <http://downloads.ti.com/mctools/esd/docs/opencl/index.html>`__
-    .. |__OpenCV__| replace:: :ref:`OpenCV <foundational-components-opencv>`
-    .. |__Multimedia__| replace:: :ref:`Multimedia <foundational-components-multimedia>`
-    .. |__Virtualization__| replace:: :ref:`Virtualization <foundational-components-virtualization>`
-    .. |__IPC__| replace:: :ref:`IPC <foundational-components-ipc>`
-    .. |__OpenVX__| replace:: :ref:`OpenVX <foundational-components-openvx>`
-    .. |__CMEM__| replace:: :ref:`CMEM <foundational-components-cmem>`
-    .. |__Machine Learning__| replace:: :ref:`Machine Learning <foundational-components-machine-learning>`
-    .. |__ATF__| replace:: :ref:`ATF <foundational-components-atf>`
-    .. |__OPTEE__| replace:: :ref:`OPTEE <foundational-components-optee>`
+   .. list-table::
+      :header-rows: 1
+
+      * - Foundational Components
+        -
+        -
+        -
+      * - :ref:`U-Boot <foundational-components-u-boot>`
+        - :ref:`Boot Monitor  <foundational-components-boot-monitor>`
+        - :ref:`Kernel <foundational-components-kernel>`
+        - :ref:`Filesystem <foundational-components-filesystem>`
+      * - :ref:`Tools <foundational-components-tools>`
+        - `OpenCL <http://downloads.ti.com/mctools/esd/docs/opencl/index.html>`__
+        - :ref:`OpenCV <foundational-components-opencv>`
+        - :ref:`Graphics & Display <foundational-components-graphics-and-display>`
+      * - :ref:`Multimedia <foundational-components-multimedia>`
+        - :ref:`Examples, Demos <examples-and-demos>`
+        - :ref:`PRU Subsystem <foundational-components-pru-subsystem>`
+        - :ref:`Virtualization <foundational-components-virtualization>`
+      * - :ref:`IPC <foundational-components-ipc>`
+        - :ref:`OpenVX <foundational-components-openvx>`
+        - :ref:`CMEM <foundational-components-cmem>`
+        - :ref:`Machine Learning <foundational-components-machine-learning>`
+      * - :ref:`ATF <foundational-components-atf>`
+        - :ref:`OPTEE <foundational-components-optee>`
+        -
+        -
 
 
 .. ifconfig:: CONFIG_part_family in ('AM335X_family', 'AM437X_family')
 
-    +--------------------------+------------------------+----------------------------+-------------+
-    | **Foundational Components** (more information on each piece of the distribution)             |
-    +==========================+========================+============================+=============+
-    | |__U-Boot__|             | |__Kernel__|           | |__Filesystem__|           | |__Tools__| |
-    +--------------------------+------------------------+----------------------------+-------------+
-    | |__Graphics & Display__| | |__Examples & Demos__| | |__PRU Subsystem__|        |             |
-    +--------------------------+------------------------+----------------------------+-------------+
+   .. list-table::
+      :header-rows: 1
 
-    .. |__U-Boot__| replace:: :ref:`U-Boot <foundational-components-u-boot>`
-    .. |__Kernel__| replace:: :ref:`Kernel <foundational-components-kernel>`
-    .. |__Filesystem__| replace:: :ref:`Filesystem <foundational-components-filesystem>`
-    .. |__Tools__| replace:: :ref:`Tools <foundational-components-tools>`
-    .. |__Graphics & Display__| replace:: :ref:`Graphics & Display <foundational-components-graphics-and-display>`
-    .. |__Examples & Demos__| replace:: :ref:`Examples, Demos <examples-and-demos>`
-    .. |__PRU Subsystem__| replace:: :ref:`PRU Subsystem <foundational-components-pru-subsystem>`
+      * - Foundational Components
+        -
+        -
+        -
+      * - :ref:`U-Boot <foundational-components-u-boot>`
+        - :ref:`Kernel <foundational-components-kernel>`
+        - :ref:`Filesystem <foundational-components-filesystem>`
+        - :ref:`Tools <foundational-components-tools>`
+      * - :ref:`Graphics & Display <foundational-components-graphics-and-display>`
+        - :ref:`Examples, Demos <examples-and-demos>`
+        - :ref:`PRU Subsystem <foundational-components-pru-subsystem>`
+        -
 
 
 .. ifconfig:: CONFIG_sdk in ('SITARA')
 
-    .. ifconfig:: CONFIG_part_variant not in ('AM62LX', 'AM62X', 'AM62AX', 'AM62PX', 'AM335X', 'AM437X', 'AM65X')
-
-        +-----------------+------------------------+------------------+-----------------------------------+
-        | **PRU-ICSS / PRU_ICSSG Protocols** (more information on each piece of the distribution)         |
-        +=================+========================+==================+===================================+
-        | |__DUAL_EMAC__| | |__HSR_PRP__|          | |__PTP__|        | |__RSTP__|                        |
-        +-----------------+------------------------+------------------+-----------------------------------+
-        | |__CCLINK__|    | |__SORTE__|            | |__OPCUA__|      |                                   |
-        +-----------------+------------------------+------------------+-----------------------------------+
-
-        .. |__DUAL_EMAC__| replace:: :ref:`DUAL_EMAC <industrial-protocols-dual-emac>`
-        .. |__HSR_PRP__| replace:: :ref:`HSR_PRP <industrial-protocols-hsr-prp>`
-        .. |__PTP__| replace:: :ref:`PTP <industrial-protocols-ptp>`
-        .. |__RSTP__| replace:: :ref:`RSTP <industrial-protocols-rstp>`
-        .. |__CCLINK__| replace:: :ref:`CCLINK <industrial-protocols-cclink>`
-        .. |__SORTE__| replace:: :ref:`SORTE <industrial-protocols-sorte>`
-        .. |__OPCUA__| replace:: :ref:`OPC/UA <industrial-protocols-opcua>`
+   .. ifconfig:: CONFIG_part_variant not in ('AM62LX', 'AM62X', 'AM62AX', 'AM62PX', 'AM335X', 'AM437X', 'AM65X')
+
+      .. list-table::
+         :header-rows: 1
+
+         * - PRU-ICSS / PRU_ICSSG Protocols
+           -
+           -
+           -
+         * - :ref:`DUAL_EMAC <industrial-protocols-dual-emac>`
+           - :ref:`HSR_PRP <industrial-protocols-hsr-prp>`
+           - :ref:`PTP <industrial-protocols-ptp>`
+           - :ref:`RSTP <industrial-protocols-rstp>`
+         * - :ref:`CCLINK <industrial-protocols-cclink>`
+           - :ref:`SORTE <industrial-protocols-sorte>`
+           - :ref:`OPC/UA <industrial-protocols-opcua>`
+           -
+
+

From a6009f892183cb0f58853b65c2a28f46a681f135 Mon Sep 17 00:00:00 2001
From: Randolph Sapp <rs@ti.com>
Date: Sat, 12 Jul 2025 13:20:37 -0500
Subject: [PATCH 2/2] chore(overview): reduce ifconfig logic

This was needlessly complicated. Reduce to the only platforms that were
affected based on previous logic.

Signed-off-by: Randolph Sapp <rs@ti.com>
---
 ...or_SDK_Linux_Software_Developers_Guide.rst | 33 +++++++++----------
 1 file changed, 15 insertions(+), 18 deletions(-)

diff --git a/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst b/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
index c81cd3488..9dc456054 100644
--- a/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
+++ b/source/linux/Overview/_Processor_SDK_Linux_Software_Developers_Guide.rst
@@ -94,24 +94,21 @@ suggestions at `E2E <https://e2e.ti.com/>`__.
         -
 
 
-.. ifconfig:: CONFIG_sdk in ('SITARA')
-
-   .. ifconfig:: CONFIG_part_variant not in ('AM62LX', 'AM62X', 'AM62AX', 'AM62PX', 'AM335X', 'AM437X', 'AM65X')
-
-      .. list-table::
-         :header-rows: 1
+.. ifconfig:: CONFIG_part_variant in ('AM64X')
 
-         * - PRU-ICSS / PRU_ICSSG Protocols
-           -
-           -
-           -
-         * - :ref:`DUAL_EMAC <industrial-protocols-dual-emac>`
-           - :ref:`HSR_PRP <industrial-protocols-hsr-prp>`
-           - :ref:`PTP <industrial-protocols-ptp>`
-           - :ref:`RSTP <industrial-protocols-rstp>`
-         * - :ref:`CCLINK <industrial-protocols-cclink>`
-           - :ref:`SORTE <industrial-protocols-sorte>`
-           - :ref:`OPC/UA <industrial-protocols-opcua>`
-           -
+   .. list-table::
+      :header-rows: 1
 
+      * - PRU-ICSS / PRU_ICSSG Protocols
+        -
+        -
+        -
+      * - :ref:`DUAL_EMAC <industrial-protocols-dual-emac>`
+        - :ref:`HSR_PRP <industrial-protocols-hsr-prp>`
+        - :ref:`PTP <industrial-protocols-ptp>`
+        - :ref:`RSTP <industrial-protocols-rstp>`
+      * - :ref:`CCLINK <industrial-protocols-cclink>`
+        - :ref:`SORTE <industrial-protocols-sorte>`
+        - :ref:`OPC/UA <industrial-protocols-opcua>`
+        -