Changes in kernel-doc

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/kernel-doc

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/kernel-doc

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/kernel-doc

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/kernel-doc

0a1a27776ddf0072883cdb4a61b91155553fcb96 - Merge branch 'mauro' into docs-mw

Sun, 22 Mar 2026 22:25:08 +0100

Merge branch 'mauro' into docs-mwThis series comes after: https://lore.kernel.org/linux-doc/cover.1773770483.git.mchehab+huawei@kernel.org/It basically contains patches I submitted before on a 40+ patch series,but were less relevant, plus a couple of other minor fixes:- patch 1 improves one of the CTokenizer unit test, fixing some potential issues on it;- patches 2 and 3 contain some improvement/fixes for Sphinx Python autodoc extension. They basically document c_lex.py;- The remaining patches: - create a new class for kernel-doc config; - fix some internal representations of KdocItem; - add unit tests for KernelDoc() parser class; - add support to output KdocItem in YAML, which is a machine-readable output for all documented kAPI.None of the patches should affect man or html output. List of files: /linux/tools/docs/kernel-doc

01d6d7bf9672f1aeabbffaa3fbfb8017223ff878 - docs: kernel-doc: add support to store output on a YAML file

Wed, 18 Mar 2026 10:11:14 +0100

docs: kernel-doc: add support to store output on a YAML fileAdd a command line parameter and library support to optionallystore:- KdocItem intermediate format after parsing;- man pages output;- rst output.inside a YAML file.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: List of files: /linux/tools/docs/kernel-doc

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/kernel-doc

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/kernel-doc

e4dadcf510da846f32aaaad5d5988890cbf6033d - docs: kdoc_output: pick a better default for modulename

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

docs: kdoc_output: pick a better default for modulenameInstead of placing the same data for modulename for all generatedman pages, use the directory from the filename used to producekernel docs as basis.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <8a5d91c93c0b9b34c2f60e389f4464742804d0d6.1772810752.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/kernel-doc

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/kernel-doc

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/kernel-doc

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/kernel-doc

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/kernel-doc

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

Wed, 21 Jan 2026 00:13:23 +0100

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/kernel-doc

35c0f975ef4a96cb488bcb5fca6e852fc347bc49 - docs: kdoc: improve description of MsgFormatter

Mon, 19 Jan 2026 13:05:03 +0100

docs: kdoc: improve description of MsgFormatterThe description there is quite vague. Make it clearer.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <94269990e2d665bec08a1b6f4d28d84939cb9d83.1768823489.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/kernel-doc

32e9a42440a230b14c438099bc5fccb5012a638a - docs: kdoc: move the return values to the helper message

Mon, 19 Jan 2026 13:05:02 +0100

docs: kdoc: move the return values to the helper messageIt makes sense to describe what kernel-doc is expected to returnon its help message. Move such messages to argparse epilog.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Message-ID: <3bcfa48016770929fcd073376515e3ff0b777ea8.1768823489.git.mchehab+huawei@kernel.org> List of files: /linux/tools/docs/kernel-doc

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

Mon, 19 Jan 2026 13:05:01 +0100

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/kernel-doc