On Mon, Oct 21, 2024 at 08:15:45PM +0200, Heinrich Schuchardt wrote:
On 10/21/24 20:12, Tom Rini wrote:
On Mon, Oct 21, 2024 at 08:01:01PM +0200, Heinrich Schuchardt wrote:
Sphinx writes a warning if a page is included twice in the table of contents. Use references instead.
Signed-off-by: Heinrich Schuchardt heinrich.schuchardt@canonical.com
doc/board/ti/k3.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-)
diff --git a/doc/board/ti/k3.rst b/doc/board/ti/k3.rst index c3513f0aee2..5d01f487622 100644 --- a/doc/board/ti/k3.rst +++ b/doc/board/ti/k3.rst @@ -32,19 +32,22 @@ K3 Based SoCs am62ax_sk am62x_sk
- ../beagle/am62x_beagleplay
- ../phytec/phycore-am62x
- ../toradex/verdin-am62 am62px_sk am64x_evm am65x_evm j7200_evm
- ../beagle/j721e_beagleboneai64 j721e_evm j721s2_evm j722s_evm j784s4_evm
+K3 SoC based boards in other sections
+* :doc:`../beagle/am62x_beagleplay` +* :doc:`../beagle/j721e_beagleboneai64` +* :doc:`../phytec/phycore-am62x` +* :doc:`../toradex/verdin-am62`
Can we just make the changes to :doc: links be inline and keep the list sorted/ordered as-is? Or does that not read well once rendered?
This is nothing Sphinx would understand:
WARNING: toctree contains reference to nonexisting document 'board/ti/:doc:`../beagle/am62x_beagleplay`' [toc.not_readable]
Hmm, maybe toctree is the wrong keyword, given where it is in the file and the rest of the contents. I think the whole list is intended as "here are all of the K3-based platforms". This however may mean that a bunch of boards then need :orphan: added as they won't strictly be in some other ToC list?