SUSE-Enceladus-keg--remove-W-from-docs-Makefile.md

Remove -W flag from docs Makefile

Error

[    2s] sphinx-build -b man -W -d build/doctrees   source build/man
[    3s] Running Sphinx v8.2.3
[    3s] WARNING: Calling get_html_theme_path is deprecated. If you are calling it to define html_theme_path, you are safe to remove that code.
[    3s] loading translations [en]... done
[    3s] making output directory... done
[    3s] Converting `source_suffix = '.rst'` to `source_suffix = {'.rst': 'restructuredtext'}`.
[    3s] loading intersphinx inventory 'python' from intersphinx_mapping/objects.inv ...
[    3s] building [mo]: targets for 0 po files that are out of date
[    3s] writing output...
[    3s] building [man]: all manpages
[    3s] updating environment: [new config] 11 added, 0 changed, 0 removed
[    3s] reading sources... [  9%] changelog_generator
[    3s] reading sources... [ 18%] commands
[    3s] reading sources... [ 27%] commands/generate_recipes_changelog
[    3s] reading sources... [ 36%] commands/keg
[    3s] reading sources... [ 45%] data_modules
[    3s] reading sources... [ 55%] image_definition
[    3s] reading sources... [ 64%] index
[    3s] reading sources... [ 73%] installation
[    3s] reading sources... [ 82%] obs_source_service
[    3s] reading sources... [ 91%] overview
[    3s] reading sources... [100%] recipes_basics
[    3s]
[    3s] looking for now-outdated files... none found
[    3s] pickling environment... done
[    3s] checking consistency... done
[    3s] preparing documents... done
[    3s] copying assets...
[    3s] copying assets: done
[    3s] writing... keg.1 {
[    3s] } generate_recipes_changelog.1 {
[    3s] } done
[    3s] build finished with problems, 1 warning (with warnings treated as errors).
[    3s] make: *** [Makefile:125: man] Error 1
[    3s] make: Leaving directory '/home/abuild/rpmbuild/BUILD/python-kiwi-keg-2.1.1-build/keg-2.1.1/doc'
[    3s] error: Bad exit status from /var/tmp/rpm-tmp.agQRvR (%build)
[    3s]
[    3s] RPM build errors:
[    3s]     Bad exit status from /var/tmp/rpm-tmp.agQRvR (%build)
[    3s]
[    3s] tumblesuse failed "build python-kiwi-keg.spec" at Fri Jun 20 19:45:56 UTC 2025.
[    3s]

Build failed with exit code 1
The buildroot was: /var/tmp/build-root/Factory-x86_64

The -W flag is treating a warning into error (exit-status 1).

sphinx-build -b man -W -d build/doctrees   source build/man

Solution

M package/python-kiwi-keg.spec
@@ -45,6 +45,7 @@ Summary:       KEG - Image Composition Tool
 Group:         Development/Tools/Building
 License:       GPL-3.0-or-later
 Source0:       %{upstream_name}-%{version}.tar.gz
+Patch0:        0001-remove-W-from-docs-Makefile.patch

Removing -W flag from docs/Makefile

0001-remove-W-from-docs-Makefile.patch

--- keg-2.1.1/doc/Makefile.orig	2025-06-20 17:04:08.032901408 -0300
+++ keg-2.1.1/doc/Makefile	2025-06-20 17:04:29.969954214 -0300
@@ -15,7 +15,7 @@
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
 PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -W -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source