[PATCH 1/1] doc: update Kernel documentation build system

[Heinrich Schuchardt]

On 1/23/21 6:53 PM, Tom Rini wrote:
> On Sat, Jan 23, 2021 at 12:46:23PM -0500, Tom Rini wrote:
>> On Fri, Jan 01, 2021 at 01:21:11AM +0100, Heinrich Schuchardt wrote:
>>
>>> Update the docomentation build system according to Linux v5.11-rc1.
>>>
>>> With this patch we can build the HTML documentation using either of
>>> Sphinx 2 and Sphinx 3.
>>>
>>> Signed-off-by: Heinrich Schuchardt <xypron.glpk at gmx.de>
>>> Reviewed-by: Simon Glass <sjg at chromium.org>
>>
>> Applied to u-boot/master, thanks!
>
> I've had to revert this.  While I caught and fixed up in a semi-logical
> way one duplicate label problem, there's another now that I see, and
> probably many more once I rework that one.  It's unclear as well how
> best to handle these otherwise logical duplicate labels, such as "eMMC"
> in doc/board/microchip/mpfs_icicle.rst for example.

Sphinx 2 is not available for current Linux distributions. Without this
patch we cannot build with Sphinx 3.

All pages must be deduplicated. Instead of duplicate information
references have to be used.

Once that is done and the patch is reapplied we must make sure that on
gitlab we use Sphinx 3 by moving to a current Ubuntu version.

Best regards

Heinrich