Docs: Turn warnings into errors
commit6d8bb8cf29653568f2446bbc7f2a1b37d3396276
authorNicholas Chin <nic.c3.14@gmail.com>
Sun, 27 Oct 2024 20:41:07 +0000 (27 14:41 -0600)
committerFelix Singer <service+coreboot-gerrit@felixsinger.de>
Sun, 27 Oct 2024 23:51:11 +0000 (27 23:51 +0000)
tree1224c70bcbf5371f969feb684db95cbd4554131f
parentd95d9f8ce82988abd0dce010cbdd3c567508196f
Docs: Turn warnings into errors

Use the -W (--fail-on-warning) flag of sphinx-build to tell it to exit
with an error if any warnings are generated. This is intended to fail
the coreboot-docs-gerrit build to help catch issues.

To allow all warnings to be output in the same build, use the
--keep-going flag so that the author is able to see all issues and
address them after a single build. Note that this behavior is enabled by
default as of Sphinx 8.1 and this option may be removed in the future.
It is added here for compatibility with older versions of Sphinx,
including the doc.coreboot.org container which uses 7.2.6.

Change-Id: I3aa564b79d4d4125a3800023b1b805bf4a50b10a
Signed-off-by: Nicholas Chin <nic.c3.14@gmail.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/84886
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Felix Singer <service+coreboot-gerrit@felixsinger.de>
Documentation/Makefile