Changes in sphinx-build-wrapper

c17ee635fd3a482b2ad2bf5e269755c2eae5f25e - Merge drm/drm-fixes into drm-misc-fixes

Mon, 23 Feb 2026 09:09:45 +0000

Merge drm/drm-fixes into drm-misc-fixes7.0-rc1 was just released, let's merge it to kick the new release cycle.Signed-off-by: Maxime Ripard List of files: /linux/tools/docs/sphinx-build-wrapper

cc4adab164b772a34b3340d644b7c4728498581e - Merge tag 'v6.19-rc1' into msm-next

Tue, 20 Jan 2026 22:06:55 +0000

Merge tag 'v6.19-rc1' into msm-nextMerge Linux 6.19-rc1 in order to catch up with other changes (e.g. UBWCconfig database defining UBWC_6).Signed-off-by: Dmitry Baryshkov List of files: /linux/tools/docs/sphinx-build-wrapper

5add3c3c280a35f7e258e9cef7607db5a2e56fdc - Merge drm/drm-next into drm-xe-next

Fri, 19 Dec 2025 10:51:22 +0000

Merge drm/drm-next into drm-xe-nextBackmerging to bring in 6.19-rc1. An important upstream bugfix andto help unblock PTL CI.Signed-off-by: Thomas Hellström List of files: /linux/tools/docs/sphinx-build-wrapper

b8304863a3990d0f18c38e5b94191830a63ee1af - Merge drm/drm-next into drm-intel-next

Mon, 15 Dec 2025 13:24:02 +0000

Merge drm/drm-next into drm-intel-nextSync-up some display code needed for Async flips refactor.Signed-off-by: Rodrigo Vivi List of files: /linux/tools/docs/sphinx-build-wrapper

7f790dd21a931c61167f7bdc327aecf2cebad327 - Merge drm/drm-next into drm-misc-next

Mon, 15 Dec 2025 08:27:39 +0000

Merge drm/drm-next into drm-misc-nextLet's kickstart the v6.20 (7.0?) release cycle.Signed-off-by: Maxime Ripard List of files: /linux/tools/docs/sphinx-build-wrapper

72c395024dac5e215136cbff793455f065603b06 - Merge tag 'docs-7.0' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux

Tue, 10 Feb 2026 04:53:18 +0000

Merge tag 'docs-7.0' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linuxPull documentation updates from Jonathan Corbet: "A slightly calmer cycle for docs this time around, though there is still a fair amount going on, including: - Some signs of life on the long-moribund Japanese translation - Documentation on policies around the use of generative tools for patch submissions, and a separate document intended for consumption by generative tools - The completion of the move of the documentation tools to tools/docs. For now we're leaving a /scripts/kernel-doc symlink behind to avoid breaking scripts - Ongoing build-system work includes the incorporation of documentation in Python code, better support for documenting variables, and lots of improvements and fixes - Automatic linking of man-page references -- cat(1), for example -- to the online pages in the HTML build ...and the usual array of typo fixes and such"* tag 'docs-7.0' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux: (107 commits) doc: development-process: add notice on testing tools: sphinx-build-wrapper: improve its help message docs: sphinx-build-wrapper: allow -v override -q docs: kdoc: Fix pdfdocs build for tools docs: ja_JP: process: translate 'Obtain a current source tree' docs: fix 're-use' -> 'reuse' in documentation docs: ioctl-number: fix a typo in ioctl-number.rst docs: filesystems: ensure proc pid substitutable is complete docs: automarkup.py: Skip common English words as C identifiers Documentation: use a source-read extension for the index link boilerplate docs: parse_features: make documentation more consistent docs: add parse_features module documentation docs: jobserver: do some documentation improvements docs: add jobserver module documentation docs: kabi: helpers: add documentation for each "enum" value docs: kabi: helpers: add helper for debug bits 7 and 8 docs: kabi: system_symbols: end docstring phrases with a dot docs: python: abi_regex: do some improvements at documentation docs: python: abi_parser: do some improvements at documentation docs: add kabi modules documentation ... List of files: /linux/tools/docs/sphinx-build-wrapper

64e4882c8228b07c57e75f510b8c5d7ff46e4edc - tools: sphinx-build-wrapper: improve its help message

Tue, 27 Jan 2026 08:03:34 +0000

tools: sphinx-build-wrapper: improve its help messageBesides the parameters that are passed via command line arguments,the wrapper's behavior is affected by several environment variables.Document that. While here, use __doc__ for its description.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/docs/sphinx-build-wrapper

b09cc1ddde9707ef62d2dd1070a1c99556ed7d76 - docs: sphinx-build-wrapper: allow -v override -q

Tue, 27 Jan 2026 08:03:33 +0000

docs: sphinx-build-wrapper: allow -v override -qDocumentation builds were using "-q" for a long time, but sometimesit is nice to see the Sphinx progress, without increasing buildverbosity - which would also turn on kernel-doc verbosity.Instead of doing that, let's parse the sphinx-build already-existing-v: each time it is used, it increases the verbosity level.With that, if the default is to use -q, a single -v will disablequiet mode. Passing more -v will keep increasing its verbosity.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <38b24e97a3cbd2def418359a8e69b1b087a945ad.1769500383.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/sphinx-build-wrapper

ffb569d59c253399efb2345ddfefe7929cd7e2a8 - tools/docs: sphinx-build-wrapper: only generate rust docs when requested

Sat, 17 Jan 2026 23:26:24 +0000

tools/docs: sphinx-build-wrapper: only generate rust docs when requestedWhen the user explicitly specifies SPHINXDIRS to build a specificsubdirectory it is unexpected that the rust docs are also generated.Especially as their generation may dominate the execution time.Only generate the rust docs when they are part of the SPHINXDIRSrequested by the user. 'rust/rustdocs' is not considered, as it isnot a valid SPHINXDIRS anyways.Signed-off-by: Thomas Weißschuh Reviewed-by: Mauro Carvalho Chehab Tested-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <20260118-docs-spurious-rust-v1-4-998e14b9ed9e@weissschuh.net> List of files: /linux/tools/docs/sphinx-build-wrapper

6f9a96cc96ea405e0f80fede761dc415e33364c7 - tools/docs: sphinx-build-wrapper: compute sphinxdirs_list earlier

Sat, 17 Jan 2026 23:26:23 +0000

tools/docs: sphinx-build-wrapper: compute sphinxdirs_list earlierAn upcoming patch will require sphinxdirs_list to be available beforethe call to check_rust().Move it up in the function.Signed-off-by: Thomas Weißschuh Reviewed-by: Mauro Carvalho Chehab Tested-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <20260118-docs-spurious-rust-v1-3-998e14b9ed9e@weissschuh.net> List of files: /linux/tools/docs/sphinx-build-wrapper

2d652135a16b413e38e6d7fed5244690d853756b - tools/docs: sphinx-build-wrapper: make 'rustdoc' a local variable

Sat, 17 Jan 2026 23:26:22 +0000

tools/docs: sphinx-build-wrapper: make 'rustdoc' a local variableAll users of this variable are now in the same method.Demote the instance variable to a local one.Signed-off-by: Thomas Weißschuh Reviewed-by: Mauro Carvalho Chehab Tested-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <20260118-docs-spurious-rust-v1-2-998e14b9ed9e@weissschuh.net> List of files: /linux/tools/docs/sphinx-build-wrapper

5094f7d5ff2318edfe6f2a9632b31f0ddefd6ee4 - tools/docs: sphinx-build-wrapper: generate rust docs only once

Sat, 17 Jan 2026 23:26:21 +0000

tools/docs: sphinx-build-wrapper: generate rust docs only onceCurrently the rust docs are generated for each entry in SPHINXDIRS.This is unnecessary as they will be the same for each one.Move the generation, so it is executed only once.Signed-off-by: Thomas Weißschuh Reviewed-by: Mauro Carvalho Chehab Tested-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <20260118-docs-spurious-rust-v1-1-998e14b9ed9e@weissschuh.net> List of files: /linux/tools/docs/sphinx-build-wrapper

11ba4215d0d6acc5a7d866a5e0a063b5a8487022 - Merge branch 'mauro' into docs-mw

Tue, 20 Jan 2026 23:13:23 +0000

Merge branch 'mauro' into docs-mwA combination of Mauro's -Werror work and my long-belated kernel-doc move. List of files: /linux/tools/docs/sphinx-build-wrapper

4a3efd128f7da996b677151790d043ec44a00561 - docs: sphinx-build-wrapper: stop setting kerneldoc_bin for Sphinx

Tue, 20 Jan 2026 22:50:38 +0000

docs: sphinx-build-wrapper: stop setting kerneldoc_bin for SphinxNow that the Sphinx build does not use the kerneldoc_bin configurationvariable, we shouldn't try to set it in the build wrapper or we get a niftywarning: WARNING: unknown config value 'kerneldoc_bin' in override, ignoringSigned-off-by: Jonathan Corbet List of files: /linux/tools/docs/sphinx-build-wrapper

eba6ffd126cd52358181ed5a179644a161f9c65f - docs: kdoc: move kernel-doc to tools/docs

Mon, 19 Jan 2026 12:05:01 +0000

docs: kdoc: move kernel-doc to tools/docskernel-doc is the last documentation-related tool still living outside ofthe tools/docs directory; the time has come to move it over.[mchehab: fixed kdoc lib location]Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <311d17e403524349940a8b12de6b5e91e554b1f4.1768823489.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/sphinx-build-wrapper

24f171c7e145f43b9f187578e89b0982ce87e54c - Merge tag 'asoc-fix-v6.19-rc1' of https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound into for-linus

Sun, 21 Dec 2025 10:11:11 +0000

Merge tag 'asoc-fix-v6.19-rc1' of https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound into for-linusASoC: Fixes for v6.19We've been quite busy with fixes since the merge window, though not inany particularly exciting ways - the standout thing is the fix for _SXcontrols which were broken by a change to how we do clamping, otherwiseit's all fairly run of the mill fixes and quirks. List of files: /linux/tools/docs/sphinx-build-wrapper

84318277d6334c6981ab326d4acc87c6a6ddc9b8 - Merge remote-tracking branch 'drm/drm-fixes' into drm-misc-fixes

Mon, 15 Dec 2025 11:53:27 +0000

Merge remote-tracking branch 'drm/drm-fixes' into drm-misc-fixesPull in rc1 to include all changes since the merge window closed,and grab all fixes and changes from drm/drm-next.Signed-off-by: Maarten Lankhorst List of files: /linux/tools/docs/sphinx-build-wrapper

f96163865a1346b199cc38e827269296f0f24ab0 - Merge tag 'docs-6.19' of git://git.lwn.net/linux

Wed, 03 Dec 2025 19:34:28 +0000

Merge tag 'docs-6.19' of git://git.lwn.net/linuxPull documentation updates from Jonathan Corbet: "This has been another busy cycle for documentation, with a lot of build-system thrashing. That work should slow down from here on out. - The various scripts and tools for documentation were spread out in several directories; now they are (almost) all coalesced under tools/docs/. The holdout is the kernel-doc script, which cannot be easily moved without some further thought. - As the amount of Python code increases, we are accumulating modules that are imported by multiple programs. These modules have been pulled together under tools/lib/python/ -- at least, for documentation-related programs. There is other Python code in the tree that might eventually want to move toward this organization. - The Perl kernel-doc.pl script has been removed. It is no longer used by default, and nobody has missed it, least of all anybody who actually had to look at it. - The docs build was controlled by a complex mess of makefilese that few dared to touch. Mauro has moved that logic into a new program (tools/docs/sphinx-build-wrapper) that, with any luck at all, will be far easier to understand and maintain. - The get_feat.pl program, used to access information under Documentation/features/, has been rewritten in Python, bringing an end to the use of Perl in the docs subsystem. - The top-level README file has been reorganized into a more reader-friendly presentation. - A lot of Chinese translation additions - Typo fixes and documentation updates as usual"* tag 'docs-6.19' of git://git.lwn.net/linux: (164 commits) docs: makefile: move rustdoc check to the build wrapper README: restructure with role-based documentation and guidelines docs: kdoc: various fixes for grammar, spelling, punctuation docs: kdoc_parser: use '@' for Excess enum value docs: submitting-patches: Clarify that removal of Acks needs explanation too docs: kdoc_parser: add data/function attributes to ignore docs: MAINTAINERS: update Mauro's files/paths docs/zh_CN: Add wd719x.rst translation docs/zh_CN: Add libsas.rst translation get_feat.pl: remove it, as it got replaced by get_feat.py Documentation/sphinx/kernel_feat.py: use class directly tools/docs/get_feat.py: convert get_feat.pl to Python Documentation/admin-guide: fix typo and comment in cscope example docs/zh_CN: Add data-integrity.rst translation docs/zh_CN: Add blk-mq.rst translation docs/zh_CN: Add block/index.rst translation docs/zh_CN: Update the Chinese translation of kbuild.rst docs: bring some order to our Python module hierarchy docs: Move the python libraries to tools/lib/python Documentation/kernel-parameters: Move the kernel build options ... List of files: /linux/tools/docs/sphinx-build-wrapper

464257baf99200d1be1c053f15aa617056361e81 - docs: makefile: move rustdoc check to the build wrapper

Fri, 21 Nov 2025 11:05:28 +0000

docs: makefile: move rustdoc check to the build wrapperThe makefile logic to detect if rust is enabled is not workingthe way it was expected: instead of using the current setupfor CONFIG_RUST, it uses a cached version from a previous build.The root cause is that the current logic inside docs/Makefileuses a cached version of CONFIG_RUST, from the last time a nondocumentation target was executed. That's perfectly fine forSphinx build, as it doesn't need to read or depend on anyCONFIG_*.So, instead of relying at the cache, move the logic to thewrapper script and let it check the current content of .config,to verify if CONFIG_RUST was selected.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/docs/sphinx-build-wrapper

34a28245b6a5c4227b7122c0ff9b98d22b39f033 - Merge branch 'python-modules' into docs-mw

Tue, 18 Nov 2025 16:26:11 +0000

Merge branch 'python-modules' into docs-mwscripts/lib was always a bit of an awkward place for Python libraries; givethem a proper home under tools/lib/python. Put the modules fromtools/docs/lib there for good measure.The second patch ties them into a single package namespace. It would bemore aesthetically pleasing to add a kernel layer, so we could say: from kernel.kdoc import kdoc_parser...and have the kernel-specific stuff clearly marked, but that means addingan empty directory in the hierarchy, which isn't as pleasing.There are some other "Python library" directories hidden in the kerneltree; we may eventually want to encourage them to move as well. List of files: /linux/tools/docs/sphinx-build-wrapper