From 9ec83d1f638f6b61a33012f40d0b88a416e0841d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20K=C4=99pie=C5=84?= Date: Fri, 21 May 2021 10:29:02 +0200 Subject: [PATCH] Explicitly set "man_make_section_directory" The default value of the "man_make_section_directory" Sphinx option was changed in Sphinx 4.0.1, which broke building man pages in maintainer mode as the shell code in doc/man/Makefile.am expects man pages to be built in doc/man/_build/man/, not doc/man/_build/man//. The aforementioned change in defaults was reverted in Sphinx 4.0.2, but this issue should still be prevented from reoccurring in the future. Ensure that by explicitly setting the "man_make_section_directory" option to False. --- doc/man/conf.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/man/conf.py b/doc/man/conf.py index b4ca747fbc..04dd6d86e9 100644 --- a/doc/man/conf.py +++ b/doc/man/conf.py @@ -40,6 +40,10 @@ author = u'Internet Systems Consortium' # -- General configuration --------------------------------------------------- +# Build man pages directly in _build/man/, not in _build/man/
/. +# This is what the shell code in Makefile.am expects. +man_make_section_directory = False + # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones.