On 8/1/21 10:37 PM, Tom Rini wrote:
On Sun, Aug 01, 2021 at 10:03:59PM +0200, Heinrich Schuchardt wrote:
Dear Kishon,
your merged patch 8baeeecbe305 ("doc: board: Move j721e document to doc/board/ti/ directory") leads to 'make html' build errors:
doc/board/index.rst:6: WARNING: toctree contains reference to nonexisting document 'board/ti/index'
looking for now-outdated files... none found pickling environment... done checking consistency... /doc/board/ti/j721e_evm.rst: WARNING: document isn't included in any toctree
Please, provide a patch with the missing file doc/board/ti/index.rst.
@Tom: Shouldn't these errors result in an error on the CI platform?
Apparently they don't, no. Please update whatever needs updating to the Azure/GitLab jobs so that htmldoc problems are errors. I think we're also overdue now to force a newer minimum version of sphinx ?
I guess you relate to doc/sphinx/requirements.txt:2
This is what we currently require: Release 2.4.4 (released Mar 05, 2020) This is the last 2. series release.
Ubuntu 20.04 LTS has Release 1.8.5 (released Mar 10, 2019) This is the latest 1. series release.
Debian Bullseyes has Release 3.4.3 (released Jan 08, 2021)
Ubuntu 21.04 and 21.10 have Release 3.5.4 (released Apr 11, 2021) This is the newest 3. series release.
Current release is Release 4.1.2 (released Jul 27, 2021)
I see no imminent need to raise the Sphinx version. If you want to, 3.5.4 is what people could get via their distro.
Best regards
Heinrich