[PATCH 2/2] doc: do not include K3 boards twice in TOC

[Heinrich Schuchardt]

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 at 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]

Best regards

Heinrich