Messages in this thread | | | Subject | Re: Linux 5.10-rc2 (docs build) | From | Randy Dunlap <> | Date | Mon, 2 Nov 2020 08:02:34 -0800 |
| |
On 11/2/20 12:33 AM, Mauro Carvalho Chehab wrote: > Em Mon, 2 Nov 2020 08:58:41 +0100 > Mauro Carvalho Chehab <mchehab@kernel.org> escreveu: > >> Hi Randy, >> >> Em Sun, 1 Nov 2020 16:01:54 -0800 >> Randy Dunlap <rdunlap@infradead.org> escreveu: >> >>> Something broke the docs build (SEVERE): >>> >>> >>> Sphinx parallel build error: >>> docutils.utils.SystemMessage: /home/rdunlap/lnx/lnx-510-rc2/Documentation/ABI/testing/sysfs-bus-rapidio:2: (SEVERE/4) Title level inconsistent: >>> >>> Attributes Common for All RapidIO Devices >>> ----------------------------------------- >>> >>> >> >> On what tree did you notice this? Linux-next or upstream?
See $Subject: 5.10-rc2
> Also: on what Sphinx version are you getting it? I'm not > able to reproduce the issue here, neither with Sphinx 2.4.4 > nor with Sphinx 3.2.1.
That could be one source of the problem: ;)
from my docs build:
Sphinx version: 1.7.6 Warning: It is recommended at least Sphinx version 1.7.9. If you want pdf, you need at least 2.4.4. Note: It is recommended at least Sphinx version 2.4.4 if you need PDF support.
> (building against next-20201102 and against 5.10-rc2)
Someone might want to update Documentation/process/changes.rst: Sphinx\ [#f1]_ 1.3 sphinx-build --version
Documentation/doc-guide/sphinx.rst also says minimal version is 1.3 but then goes on to discuss other versions. It's a bit of a mess.
thanks. -- ~Randy
| |