Changes in sphinx-build-wrapper

0fc8f6200d2313278fbf4539bbab74677c685531 - Merge drm/drm-fixes into drm-misc-fixes

Mon, 27 Apr 2026 10:26:49 +0200

Merge drm/drm-fixes into drm-misc-fixesGetting fixes and updates from v7.1-rc1.Signed-off-by: Thomas Zimmermann List of files: /linux/tools/docs/sphinx-build-wrapper

f4b369c6fe0ceaba2da2daff8c9eb415f85926dd - Merge branch 'next' into for-linus

Mon, 20 Apr 2026 03:28:57 +0200

Merge branch 'next' into for-linusPrepare input updates for 7.1 merge window. List of files: /linux/tools/docs/sphinx-build-wrapper

0421ccdfad0d92713a812a5aeb7d07b0ea7213c8 - Merge tag 'v7.0-rc3' into next

Thu, 12 Mar 2026 18:44:42 +0100

Merge tag 'v7.0-rc3' into nextSync up with the mainline to brig up the latest changes, specificallychanges to ALPS driver. List of files: /linux/tools/docs/sphinx-build-wrapper

5181afcdf99527dd92a88f80fc4d0d8013e1b510 - Merge tag 'docs-7.1' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux

Tue, 14 Apr 2026 17:47:08 +0200

Merge tag 'docs-7.1' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linuxPull documentation updates from Jonathan Corbet: "A busier cycle than I had expected for docs, including: - Translations: some overdue updates to the Japanese translations, Chinese translations for some of the Rust documentation, and the beginnings of a Portuguese translation. - New documents covering CPU isolation, managed interrupts, debugging Python gbb scripts, and more. - More tooling work from Mauro, reducing docs-build warnings, adding self tests, improving man-page output, bringing in a proper C tokenizer to replace (some of) the mess of kernel-doc regexes, and more. - Update and synchronize changes.rst and scripts/ver_linux, and put both into alphabetical order. ... and a long list of documentation updates, typo fixes, and general improvements"* tag 'docs-7.1' of git://git.kernel.org/pub/scm/linux/kernel/git/docs/linux: (162 commits) Documentation: core-api: real-time: correct spelling doc: Add CPU Isolation documentation Documentation: Add managed interrupts Documentation: seq_file: drop 2.6 reference docs/zh_CN: update rust/index.rst translation docs/zh_CN: update rust/quick-start.rst translation docs/zh_CN: update rust/coding-guidelines.rst translation docs/zh_CN: update rust/arch-support.rst translation docs/zh_CN: sync process/2.Process.rst with English version docs/zh_CN: fix an inconsistent statement in dev-tools/testing-overview tracing: Documentation: Update histogram-design.rst for fn() handling docs: sysctl: Add documentation for /proc/sys/xen/ Docs: hid: intel-ish-hid: make long URL usable Documentation/kernel-parameters: fix architecture alignment for pt, nopt, and nobypass sched/doc: Update yield_task description in sched-design-CFS Documentation/rtla: Convert links to RST format docs: fix typos and duplicated words across documentation docs: fix typo in zoran driver documentation docs: add an Assisted-by mention to submitting-patches.rst Revert "scripts/checkpatch: add Assisted-by: tag validation" ... List of files: /linux/tools/docs/sphinx-build-wrapper

d642acfd597e3ec37138f9a8f5a634845e3612fd - doc tools: better handle KBUILD_VERBOSE

Fri, 27 Mar 2026 06:57:48 +0100

doc tools: better handle KBUILD_VERBOSEAs reported by Jacob, there are troubles when KBUILD_VERBOSE isset at the environment.Fix it on both kernel-doc and sphinx-build-wrapper.Reported-by: Jacob Keller Closes: https://lore.kernel.org/linux-doc/9367d899-53af-4d9c-9320-22fc4dbadca5@intel.com/Signed-off-by: Mauro Carvalho Chehab Tested-by: Jacob Keller Signed-off-by: Jonathan Corbet Message-ID: <7a99788db75630fb14828d612c0fd77c45ec1891.1774591065.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/sphinx-build-wrapper

42d3b66d4cdbacfc9d120d2301b8de89cc29a914 - Merge drm/drm-next into drm-xe-next

Thu, 12 Mar 2026 15:17:56 +0100

Merge drm/drm-next into drm-xe-nextBackmerging to bring in 7.00-rc3. Important ahead GPU SVM merging THPsupport.Signed-off-by: Matthew Brost List of files: /linux/tools/docs/sphinx-build-wrapper

73f175a46330c57ab5797287233cbf83a36b6a99 - Merge branch 'mauro' into docs-mw

Mon, 09 Mar 2026 17:38:27 +0100

Merge branch 'mauro' into docs-mwMauro says:The first patches on this series are focused mostly on .TH(troff header) line, but, as a side effect, it also changethe name of man pages generated from DOC kernel-doc annotations.At the previous state, those were overriden due to lots ofduplicated names.The rationale for most of such changes is that modern troff/manpage specs say that .TH has up to 5 arguments,, as defined at [1]: .TH topic section [footer-middle] [footer-inside] [header-middle][1] https://man7.org/linux/man-pages/man7/groff_man_style.7.htmlRight now, Kernel uses 6 arguments, probably due to some legacyman page definitions.After double checking, modern man pages use this format: .TH "{name}" {section} "{date}" "{modulename}" "{manual}"Right now, man pages generation are messing up on how it encodeseach position at .TH, depending on the type of object it emits.After this series, the definition is more consistent and fileoutput is better named.It also fixes two issues at sphinx-build-wrapper related to howit generate files names from the .TH header.The last 4 patches on this series are new: they fix lots of issuesrelated to groff format: there, new lines continue the test fromprevious pagragraph. This cause issues mainly on:- tables;- code blocks;- listsWith the changes, the output now looks a lot better.Please notice that the code there is not meant to fully implementrst -> troff/groff conversion. Instead, it is meant to make theoutput reasonable.A more complete approach would be to use docutils or Sphinxlibraries, but that would likely require to also write a troffoutput plugin, as the "man" builder is very limited. Also,this could be problematic, as kernel-doc classes can be calledfrom Sphinx. I don't think we need that much complexity, as whatwe mainly need is to avoid bad line grouping when generatingman pages.This series should not affect HTML documentation. It only affectman page generation and ManFormat output class. List of files: /linux/tools/docs/sphinx-build-wrapper

4160533d058cfa667159e8d6a46fe42c738a4a84 - docs: kdoc_output: fix naming for DOC markups

Fri, 06 Mar 2026 16:45:45 +0100

docs: kdoc_output: fix naming for DOC markupsRight now, DOC markups aren't being handled properly, as it wasusing the same name for all output.Fix it by filling the title argument on a different way.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <11d809e5c4bec23240d3ace3f342dbb2a9263446.1772810752.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/sphinx-build-wrapper

0e4c8adad4cacf699672d28e19143dc0b9d145fd - docs: sphinx-build-wrapper: don't allow "/" on file names

Fri, 06 Mar 2026 16:45:40 +0100

docs: sphinx-build-wrapper: don't allow "/" on file namesWhen handling "DOC:" sections, slash characters may be there.Prevent using it at the file names, as this is used for directoryseparator.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/docs/sphinx-build-wrapper

5828d3564729e61306456fae02e9d0dc9f2e772d - docs: sphinx-build-wrapper: better handle troff .TH markups

Fri, 06 Mar 2026 16:45:39 +0100

docs: sphinx-build-wrapper: better handle troff .TH markupsUsing a regular expression to match .TH is problematic, as itdoesn't handle well quotation marks.Use shlex instead.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <9436806316d33aaf68625c00ce068463d3917660.1772810752.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/sphinx-build-wrapper

f09812b85fa6f41058bcc46e70ac406bf9b0493a - Merge drm/drm-next into drm-intel-next

Wed, 25 Feb 2026 12:23:04 +0100

Merge drm/drm-next into drm-intel-nextSync with v7.0-rc1 which contains a few treewide changes affecting i915.Signed-off-by: Jani Nikula List of files: /linux/tools/docs/sphinx-build-wrapper

8b85987d3cf50178f67618122d9f3bb202f62f42 - Merge drm/drm-next into drm-misc-next

Mon, 23 Feb 2026 11:48:20 +0100

Merge drm/drm-next into drm-misc-nextLet's merge 7.0-rc1 to start the new drm-misc-next windowSigned-off-by: Maxime Ripard List of files: /linux/tools/docs/sphinx-build-wrapper

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

Mon, 23 Feb 2026 10:09:45 +0100

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

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

Tue, 10 Feb 2026 05:53:18 +0100

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 09:03:34 +0100

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 09:03:33 +0100

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

Sun, 18 Jan 2026 00:26:24 +0100

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

Sun, 18 Jan 2026 00:26:23 +0100

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

Sun, 18 Jan 2026 00:26:22 +0100

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

Sun, 18 Jan 2026 00:26:21 +0100

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