Received-SPF: pass (google.com: domain of linux-kernel+bounces-99165-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
From: Jonathan Corbet <corbet@lwn.net>
To: Linus Torvalds <torvalds@linuxfoundation.org>
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [GIT PULL] Documentation for 6.9
Date: Mon, 11 Mar 2024 09:59:37 -0600
Message-ID: <87cys0hi8m.fsf@meer.lwn.net>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain

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