The following changes since commit b7b2ffc3ca59b06397550f96febe95f3f153eb1e: docs: translations: use attribute to store current language (2024-02-21 13:41:37 -0700) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-6.9 for you to fetch changes up to 0c8e9b538ed7ecf4159b080ab0dafca3941c69db: docs: verify/bisect: fixes, finetuning, and support for Arch (2024-03-07 04:19:43 -0700) ---------------------------------------------------------------- A moderately busy cycle for development this time around. - Some cleanup of the main index page for easier navigation - Rework some of the other top-level pages for better readability and, with luck, fewer merge conflicts in the future. - Submit-checklist improvements, hopefully the first of many. - New Italian translations - A fair number of kernel-doc fixes and improvements. We have also dropped the recommendation to use an old version of Sphinx. - A new document from Thorsten on bisection ...and lots of fixes and updates. Expect minor merge conflicts with the vfio, edac, and gpio-brgl trees, all of which are long since (and correctly) resolved in linux-next. ---------------------------------------------------------------- Abhishek Pandit-Subedi (1): coding-style: Add guidance to prefer dev_dbg Akira Yokosawa (4): docs: Restore "smart quotes" for quotes docs: kerneldoc-preamble.sty: Remove code for Sphinx <2.4 docs: Move ja_JP/howto.rst to ja_JP/process/howto.rst docs: Makefile: Add dependency to $(YNL_INDEX) for targets other than htmldocs Andrew Ballance (1): docs: sphinx-pre-install fix-noto-sans-cjk on fedora Anna-Maria Behnsen (2): drm/vram-helper: Fix 'multi-line' kernel-doc comments scripts/kernel-doc: Do not process backslash lines in comments Carlos Bilbao (2): docs: Correct formatting of title in admin-guide/index.rst docs: Include simplified link titles in main index Christoph Anton Mitterer (1): docs: proc.rst: comm: mention the included NUL Davide Benini (1): doc:it_IT: add translation for I2C summary and protocol Federico Vaga (2): doc:it_IT: first translation for locking/ doc:it_IT: remove unreferenced and not translated page Guilherme G. Piccoli (1): docs: Document possible_cpus parameter Hunter Chasens (1): docs: admin-guide: Update bootloader and installation instructions Jeffrey Hugo (1): Documentation: embargoed-hardware-issues.rst: Fix Trilok's email Johannes Berg (1): kernel-doc: handle #if in enums as well Jonathan Corbet (3): docs: rework the driver-api top-level page docs: rework the userspace-api top page Merge branch 'docs-fixes' into docs-mw Juntong Deng (1): kasan: Add documentation for CONFIG_KASAN_EXTRA_INFO Konstantin Ryabitsev (1): Documentation: update mailing list addresses Krzysztof Kozlowski (1): docs: maintainer: add existing SoC and netdev profiles Leo Yan (1): Documentation: userspace-api: Document perf ring buffer mechanism Lu Dai (1): docs/zh_CN: accurate translation of "function" Lukas Bulwahn (4): doc:it_IT: fix a typo in the config name in RCU torture docs: drop the version constraints for sphinx and dependencies docs: submit-checklist: structure by category docs: submit-checklist: use subheadings Michael Kelley (1): docs: Fix subsystem APIs page so ungrouped entries have their own header Ran.Park (1): Fixed case issue with 'fault-injection' in documentation Randy Dunlap (2): kernel-doc: drop looking for "MACDOC" doc-guide: kernel-doc: tell about object-like macros Sakari Ailus (1): kernel-doc: Support arrays of pointers struct fields SeongJae Park (1): MAINTAINERS: Set the field name for subsystem profile section Thorsten Blum (8): Documentation: coding-style: Fix indentation in code-blocks Documentation: coding-style: Update syntax highlighting for code-blocks Documentation: multiple .rst files: Fix grammar and more consistent formatting Documentation: admin-guide: tainted-kernels.rst: Add missing article and comma README: Fix spelling/capitalization docs: dev-tools: checkpatch.rst: Fix grammar docs: scripts: sphinx-pre-install: Fix building docs with pyyaml package docs: Makefile: Fix make cleandocs by deleting generated .rst files Thorsten Leemhuis (2): docs: new text on bisecting which also covers bug validation docs: verify/bisect: fixes, finetuning, and support for Arch Vegard Nossum (8): docs: add blurb about target audience to maintainer-profile scripts/kernel-doc: reindent scripts/kernel-doc: add modeline for vim users scripts/kernel-doc: simplify function printing scripts/kernel-doc: separate out function signature scripts/kernel-doc: simplify signature printing doc: kerneldoc.py: fix indentation docs: kernel_feat.py: fix build error for missing files Vincenzo Mezzela (1): docs: staging: fix typo in docs Documentation/ABI/testing/sysfs-bus-vdpa | 10 +- Documentation/Makefile | 5 +- Documentation/RCU/torture.rst | 2 +- Documentation/admin-guide/README.rst | 69 +- Documentation/admin-guide/index.rst | 2 + Documentation/admin-guide/kernel-parameters.txt | 5 + Documentation/admin-guide/tainted-kernels.rst | 4 +- .../verify-bugs-and-bisect-regressions.rst | 1952 +++++++++++++++ Documentation/conf.py | 6 +- Documentation/dev-tools/checkpatch.rst | 4 +- Documentation/dev-tools/kasan.rst | 21 + Documentation/doc-guide/kernel-doc.rst | 45 + Documentation/doc-guide/maintainer-profile.rst | 7 + Documentation/doc-guide/sphinx.rst | 18 +- Documentation/driver-api/index.rst | 169 +- Documentation/fault-injection/index.rst | 2 +- Documentation/filesystems/proc.rst | 4 +- Documentation/index.rst | 52 +- .../maintainer/maintainer-entry-profile.rst | 3 + Documentation/networking/bridge.rst | 2 +- Documentation/process/changes.rst | 4 +- Documentation/process/coding-style.rst | 13 +- .../process/embargoed-hardware-issues.rst | 2 +- Documentation/process/howto.rst | 4 +- Documentation/process/researcher-guidelines.rst | 2 +- Documentation/process/submit-checklist.rst | 161 +- Documentation/sphinx/kerneldoc-preamble.sty | 7 +- Documentation/sphinx/kerneldoc.py | 6 +- Documentation/sphinx/requirements.txt | 7 +- Documentation/staging/rpmsg.rst | 2 +- Documentation/subsystem-apis.rst | 2 + Documentation/translations/it_IT/RCU/index.rst | 19 + Documentation/translations/it_IT/RCU/torture.rst | 369 +++ .../translations/it_IT/core-api/index.rst | 12 + .../translations/it_IT/i2c/i2c-protocol.rst | 99 + Documentation/translations/it_IT/i2c/index.rst | 46 + Documentation/translations/it_IT/i2c/summary.rst | 64 + Documentation/translations/it_IT/index.rst | 2 + Documentation/translations/it_IT/locking/index.rst | 20 + .../translations/it_IT/locking/lockdep-design.rst | 678 ++++++ .../translations/it_IT/locking/lockstat.rst | 230 ++ .../translations/it_IT/locking/locktorture.rst | 181 ++ .../translations/it_IT/locking/locktypes.rst | 547 +++++ .../translations/it_IT/networking/netdev-FAQ.rst | 13 - .../translations/it_IT/process/coding-style.rst | 6 +- .../translations/it_IT/subsystem-apis.rst | 47 + Documentation/translations/ja_JP/index.rst | 2 +- .../translations/ja_JP/{ => process}/howto.rst | 0 .../translations/sp_SP/process/coding-style.rst | 6 +- .../sp_SP/process/embargoed-hardware-issues.rst | 2 +- .../sp_SP/process/researcher-guidelines.rst | 2 +- .../translations/zh_CN/process/coding-style.rst | 4 +- .../zh_CN/process/embargoed-hardware-issues.rst | 2 +- .../zh_CN/userspace-api/accelerators/ocxl.rst | 4 +- .../translations/zh_TW/process/coding-style.rst | 4 +- .../zh_TW/process/embargoed-hardware-issues.rst | 2 +- Documentation/userspace-api/index.rst | 47 +- Documentation/userspace-api/perf_ring_buffer.rst | 830 +++++++ MAINTAINERS | 9 +- README | 2 +- drivers/gpu/drm/drm_gem_vram_helper.c | 44 +- include/drm/drm_gem_vram_helper.h | 16 +- scripts/kernel-doc | 2531 ++++++++++---------- scripts/sphinx-pre-install | 32 +- 64 files changed, 6857 insertions(+), 1607 deletions(-) create mode 100644 Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst create mode 100644 Documentation/translations/it_IT/RCU/index.rst create mode 100644 Documentation/translations/it_IT/RCU/torture.rst create mode 100644 Documentation/translations/it_IT/i2c/i2c-protocol.rst create mode 100644 Documentation/translations/it_IT/i2c/index.rst create mode 100644 Documentation/translations/it_IT/i2c/summary.rst create mode 100644 Documentation/translations/it_IT/locking/index.rst create mode 100644 Documentation/translations/it_IT/locking/lockdep-design.rst create mode 100644 Documentation/translations/it_IT/locking/lockstat.rst create mode 100644 Documentation/translations/it_IT/locking/locktorture.rst create mode 100644 Documentation/translations/it_IT/locking/locktypes.rst delete mode 100644 Documentation/translations/it_IT/networking/netdev-FAQ.rst create mode 100644 Documentation/translations/it_IT/subsystem-apis.rst rename Documentation/translations/ja_JP/{ => process}/howto.rst (100%) create mode 100644 Documentation/userspace-api/perf_ring_buffer.rst