doc: board: ti: Optimize sources references

We have duplication of sources which makes it hard to sustain across the
board, but at the same time, we'd like to ensure readers get specific
information without having to cross refer to different documentation to
get piecemeal information that they need to put together.

Reviewed-by: Neha Malcom Francis <n-francis@ti.com>
Reviewed-by: Tom Rini <trini@konsulko.com>
Signed-off-by: Nishanth Menon <nm@ti.com>

diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
index 0721ee30749a51f72eba43517ed07a1153a372a1..0a3bbdfaf022a47ee63227be46f40d0c91fc4591 100644 (file)
--- a/doc/board/ti/am62x_sk.rst
+++ b/doc/board/ti/am62x_sk.rst
@@ -115,21 +115,10 @@ Below is the pictorial representation of boot flow:
 
 Sources:
 --------
-1. Trusted Firmware-A:
-       Tree: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/
-       Branch: master
-
-2. OP-TEE:
-       Tree: https://github.com/OP-TEE/optee_os.git
-       Branch: master
-
-3. U-Boot:
-       Tree: https://source.denx.de/u-boot/u-boot
-       Branch: master
 
-4. TI Linux Firmware:
-       Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
-       Branch: ti-linux-firmware
+.. include::  k3.rst
+    :start-after: .. k3_rst_include_start_boot_sources
+    :end-before: .. k3_rst_include_end_boot_sources
 
 Build procedure:
 ----------------

diff --git a/doc/board/ti/am65x_evm.rst b/doc/board/ti/am65x_evm.rst
index 82bae7c633ab719dfb0a58e66874a0daa61af79e..93b983fda63842def52ef5d133db8decadd99782 100644 (file)
--- a/doc/board/ti/am65x_evm.rst
+++ b/doc/board/ti/am65x_evm.rst
@@ -117,21 +117,10 @@ instead use Falcon boot flow to reduce boot time.
 
 Sources:
 --------
-1. Trusted Firmware-A:
-        Tree: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/
-        Branch: master
-
-2. OP-TEE:
-        Tree: https://github.com/OP-TEE/optee_os.git
-        Branch: master
-
-3. U-Boot:
-        Tree: https://source.denx.de/u-boot/u-boot
-        Branch: master
 
-4. TI Linux Firmware:
-        Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
-        Branch: ti-linux-firmware
+.. include::  k3.rst
+    :start-after: .. k3_rst_include_start_boot_sources
+    :end-before: .. k3_rst_include_end_boot_sources
 
 Build procedure:
 ----------------

diff --git a/doc/board/ti/j7200_evm.rst b/doc/board/ti/j7200_evm.rst
index 909eb509638ca3fc11be0e0ffcd648296e97161f..24d309a9ff15ec1299372e9b624087578f9fd4f1 100644 (file)
--- a/doc/board/ti/j7200_evm.rst
+++ b/doc/board/ti/j7200_evm.rst
@@ -120,21 +120,10 @@ Below is the pictorial representation of boot flow:
 
 Sources:
 --------
-1. Trusted Firmware-A:
-       Tree: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/
-       Branch: master
-
-2. OP-TEE:
-       Tree: https://github.com/OP-TEE/optee_os.git
-       Branch: master
-
-3. U-Boot:
-       Tree: https://source.denx.de/u-boot/u-boot
-       Branch: master
 
-4. TI Linux Firmware:
-       Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
-       Branch: ti-linux-firmware
+.. include::  k3.rst
+    :start-after: .. k3_rst_include_start_boot_sources
+    :end-before: .. k3_rst_include_end_boot_sources
 
 Build procedure:
 ----------------

diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
index a93160b7748212bd5b9bba2780ee4a3788f44a15..637b42d7c6de0a57339157d300335f48b3dec94a 100644 (file)
--- a/doc/board/ti/j721e_evm.rst
+++ b/doc/board/ti/j721e_evm.rst
@@ -130,21 +130,10 @@ support. Below is the pictorial representation of boot flow:
 
 Sources:
 --------
-1. Trusted Firmware-A:
-       Tree: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/
-       Branch: master
-
-2. OP-TEE:
-       Tree: https://github.com/OP-TEE/optee_os.git
-       Branch: master
-
-3. U-Boot:
-       Tree: https://source.denx.de/u-boot/u-boot
-       Branch: master
 
-4. TI Linux Firmware:
-       Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
-       Branch: ti-linux-firmware
+.. include::  k3.rst
+    :start-after: .. k3_rst_include_start_boot_sources
+    :end-before: .. k3_rst_include_end_boot_sources
 
 Build procedure:
 ----------------

diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst
index 2db7bbdb42ecb9e267850762e2a88f908c180d9e..2df57c9850ae3cb1fdb3a7bda39cdbf651e42a0a 100644 (file)
--- a/doc/board/ti/k3.rst
+++ b/doc/board/ti/k3.rst
@@ -111,6 +111,8 @@ All scripts and code needed to build the `tiboot3.bin`, `tispl.bin` and
 `u-boot.img` for all K3 SoCs can be located at the following places
 online
 
+.. k3_rst_include_start_boot_sources
+
 * **Das U-Boot**
 
   | **source:** https://source.denx.de/u-boot/u-boot.git
@@ -131,6 +133,8 @@ online
   | **source:** https://git.ti.com/git/processor-firmware/ti-linux-firmware.git
   | **branch:** ti-linux-firmware
 
+.. k3_rst_include_end_boot_sources
+
 Build Procedure
 ---------------