[GIT PULL] Documentation for 6.8
From: Jonathan Corbet
Date: Mon Jan 08 2024 - 13:59:40 EST
The following changes since commit b85ea95d086471afb4ad062012a4d73cd328fa86:
Linux 6.7-rc1 (2023-11-12 16:19:07 -0800)
are available in the Git repository at:
git://git.lwn.net/linux.git tags/docs-6.8
for you to fetch changes up to 2d179e8ac02e33c82c1a314961254353eb5028b3:
MAINTAINERS: use tabs for indent of CONFIDENTIAL COMPUTING THREAT MODEL (2024-01-08 11:39:00 -0700)
----------------------------------------------------------------
Another moderately busy cycle for documentation, including:
- The minimum Sphinx requirement has been raised to 2.4.4, following a
warning that was added in 6.2.
- Some reworking of the Documentation/process front page to, hopefully,
make it more useful.
- Various kernel-doc tweaks to, for example, make it deal properly with
__counted_by annotations.
- We have also restored a warning for documentation of nonexistent
structure members that disappeared a while back. That had the delightful
consequence of adding some 600 warnings to the docs build. A sustained
effort by Randy, Vegard, and myself has addressed almost all of those,
bringing the documentation back into sync with the code. The fixes are
going through the appropriate maintainer trees.
- Various improvements to the HTML rendered docs, including automatic links
to Git revisions and a nice new pulldown to make translations easy to
access.
- Speaking of translations, more of those for Spanish and Chinese.
...plus the usual stream of documentation updates and typo fixes.
There is somewhat more than the usual number of merge conflicts, alas,
including with the security, RCU, crypto, and amdgpu trees. Most of
these are in driver-api/index.rst and userspace-api/index.rst, which are
suffering from the "everybody adds new stuff to the end" problem;
imposing some order there is on my list of things to do.
----------------------------------------------------------------
Alejandro Colomar (1):
CREDITS, MAINTAINERS, docs/process/howto: Update man-pages' maintainer
Andy Shevchenko (1):
kernel-doc: Align quick help and the code
Ariel Miculas (1):
docs: vfs: fix typo in struct xattr_handlers
Avadhut Naik (4):
docs/sp_SP: Add translation of process/management-style
docs/sp_SP: Add translation of process/submit-checklist
docs/sp_SP: Warn of links pointing to documentation in English
docs/sp_SP: Move howto.rst into /sp_SP/process/
Borislav Petkov (AMD) (1):
docs: submitting-patches: improve the base commit explanation
Brian Johannesmeyer (1):
docs: dma-api: Fix description of the sync_sg API
Carlos Bilbao (2):
docs/sp_SP: Add translation of process/handling-regressions
MAINTAINERS: add reviewer for Spanish translations
Donald Hunter (1):
docs: Change <h4> style to use smaller font size than <h3>
Hu Haowen (1):
docs/zh_TW: replace my email address
Jakub Kicinski (1):
MAINTAINERS: use tabs for indent of CONFIDENTIAL COMPUTING THREAT MODEL
JiaLong.Yang (1):
Docs/zh_CN: Fix the meaning of DEBUG to pr_debug()
Jonathan Corbet (4):
Merge branch 'vegard' into docs-mw
docs: Raise the minimum Sphinx requirement to 2.4.4
docs: ignore __counted_by attribute in structure definitions
A reworked process/index.rst
Kees Cook (2):
docs: conf.py: Ignore __counted_by attribute
scripts: kernel-doc: Clarify missing struct member description
Li Zhijian (1):
docs: dma: update a reference to a moved document
Luca Ceresoli (2):
docs: nvmem: generate kernel-doc API documentation
docs: nvmem: remove function parameters (fixes hyperlink generation)
Matthew Cassell (1):
Documentation/trace: Fixed typos in the ftrace FLAGS section
Randy Dunlap (4):
fs: vboxsf: fix a kernel-doc warning
scripts/kernel-doc: restore warning for Excess struct/union
scripts/get_abi.pl: ignore some temp files
kernel-doc: handle a void function without producing a warning
Rex Nie (1):
Documentation: Remove redundant file names from examples
Steven Rostedt (Google) (1):
ring-buffer/Documentation: Add documentation on buffer_percent file
Sumit Garg (1):
Documentation: Destage TEE subsystem documentation
Thomas Weißschuh (1):
Docs: remove mentions of fdformat from util-linux
Vegard Nossum (18):
docs: style toctree captions as headings
doc: userspace-api: properly format ToC headings
media: admin-guide: properly format ToC heading
crypto: doc: properly format ToC headings
Documentation: dev-tools: properly format ToC headingss
docs: driver-api: properly format ToC headings
input: docs: properly format ToC headings
doc: misc-device: properly format ToC heading
media: doc: properly format ToC headings
docs: use toctree :caption: and move introduction
docs: remove .toc-title class
docs: automarkup: linkify git revs
Documentation: add tux logo
docs: translations: add translations links when they exist
scripts/get_abi: fix source path leak
docs: kernel_abi.py: fix command injection
Documentation: move driver-api/isapnp to userspace-api/
Documentation: move driver-api/dcdbas to userspace-api/
Vlastimil Babka (1):
Documentation, mm/unaccepted: document accept_memory kernel parameter
Yanteng Si (3):
docs/zh_CN: add process maintainer-pgp-guide tanslation
docs/zh_CN: Adjust the number of characters per line in magic-number.rst to less than 40
docs/zh_CN: Update process index to 6.7-rc2
Yuanhsi Chung (1):
Documentation: Fix filename typo in ftrace doc
attreyee-muk (1):
Documentation/core-api : fix typo in workqueue
longjin (1):
Translated the RISC-V architecture boot documentation.
CREDITS | 7 +
Documentation/admin-guide/abi-obsolete.rst | 2 +-
Documentation/admin-guide/abi-removed.rst | 2 +-
Documentation/admin-guide/abi-stable.rst | 2 +-
Documentation/admin-guide/abi-testing.rst | 2 +-
Documentation/admin-guide/dynamic-debug-howto.rst | 6 +-
Documentation/admin-guide/kernel-parameters.txt | 11 +
Documentation/admin-guide/media/index.rst | 10 +-
Documentation/arch/x86/boot.rst | 2 +-
Documentation/bpf/btf.rst | 6 +-
Documentation/conf.py | 9 +-
Documentation/core-api/dma-api-howto.rst | 2 +-
Documentation/core-api/dma-api.rst | 2 +-
Documentation/core-api/workqueue.rst | 2 +-
Documentation/crypto/api.rst | 5 +-
Documentation/crypto/index.rst | 5 +-
Documentation/dev-tools/index.rst | 5 +-
Documentation/doc-guide/sphinx.rst | 11 +-
Documentation/driver-api/index.rst | 8 +-
Documentation/driver-api/media/index.rst | 7 +-
Documentation/driver-api/mei/index.rst | 7 +-
Documentation/driver-api/nvmem.rst | 8 +-
Documentation/driver-api/pci/index.rst | 5 +-
Documentation/driver-api/tee.rst | 66 ++
Documentation/filesystems/vfs.rst | 2 +-
Documentation/input/input_kapi.rst | 5 +-
Documentation/input/input_uapi.rst | 5 +-
Documentation/input/joydev/index.rst | 5 +-
Documentation/livepatch/callbacks.rst | 4 +-
Documentation/misc-devices/index.rst | 5 +-
Documentation/networking/snmp_counter.rst | 16 +-
Documentation/process/changes.rst | 6 +-
Documentation/process/development-process.rst | 19 +-
Documentation/process/howto.rst | 3 +-
Documentation/process/index.rst | 84 ++-
Documentation/process/submitting-patches.rst | 15 +-
Documentation/security/keys/trusted-encrypted.rst | 2 +-
Documentation/sphinx-static/custom.css | 63 ++
Documentation/sphinx-static/theme_overrides.css | 5 -
Documentation/sphinx/automarkup.py | 26 +-
Documentation/sphinx/cdomain.py | 6 +-
Documentation/sphinx/kernel_abi.py | 56 +-
Documentation/sphinx/kfigure.py | 8 +-
Documentation/sphinx/templates/translations.html | 15 +
Documentation/sphinx/translations.py | 101 +++
Documentation/staging/index.rst | 1 -
Documentation/staging/tee.rst | 364 ----------
Documentation/subsystem-apis.rst | 1 +
Documentation/tee/amd-tee.rst | 90 +++
Documentation/tee/index.rst | 19 +
Documentation/tee/op-tee.rst | 166 +++++
Documentation/tee/tee.rst | 22 +
Documentation/trace/ftrace-uses.rst | 4 +-
Documentation/trace/ftrace.rst | 17 +-
.../it_IT/process/development-process.rst | 19 +-
Documentation/translations/sp_SP/disclaimer-sp.rst | 3 +
Documentation/translations/sp_SP/index.rst | 1 -
.../sp_SP/process/handling-regressions.rst | 797 +++++++++++++++++++++
.../translations/sp_SP/{ => process}/howto.rst | 2 +-
Documentation/translations/sp_SP/process/index.rst | 4 +
.../sp_SP/process/management-style.rst | 299 ++++++++
.../sp_SP/process/submit-checklist.rst | 133 ++++
.../translations/zh_CN/arch/riscv/boot.rst | 155 ++++
.../translations/zh_CN/arch/riscv/index.rst | 1 +
.../translations/zh_CN/core-api/printk-basics.rst | 2 +-
.../translations/zh_CN/dev-tools/index.rst | 5 +-
.../zh_CN/dev-tools/testing-overview.rst | 2 +-
.../translations/zh_CN/driver-api/gpio/index.rst | 3 +-
.../translations/zh_CN/driver-api/index.rst | 5 +-
.../zh_CN/process/development-process.rst | 5 +-
Documentation/translations/zh_CN/process/index.rst | 53 +-
.../translations/zh_CN/process/magic-number.rst | 69 +-
.../zh_CN/process/maintainer-pgp-guide.rst | 789 ++++++++++++++++++++
.../translations/zh_CN/userspace-api/index.rst | 5 +-
Documentation/translations/zh_TW/IRQ.txt | 8 +-
.../translations/zh_TW/admin-guide/README.rst | 2 +-
.../translations/zh_TW/admin-guide/bug-bisect.rst | 2 +-
.../translations/zh_TW/admin-guide/bug-hunting.rst | 2 +-
.../zh_TW/admin-guide/clearing-warn-once.rst | 2 +-
.../translations/zh_TW/admin-guide/cpu-load.rst | 2 +-
.../translations/zh_TW/admin-guide/index.rst | 2 +-
.../translations/zh_TW/admin-guide/init.rst | 2 +-
.../zh_TW/admin-guide/reporting-issues.rst | 2 +-
.../zh_TW/admin-guide/security-bugs.rst | 2 +-
.../zh_TW/admin-guide/tainted-kernels.rst | 2 +-
.../translations/zh_TW/admin-guide/unicode.rst | 2 +-
.../translations/zh_TW/arch/arm64/amu.rst | 2 +-
.../translations/zh_TW/arch/arm64/booting.txt | 4 +-
.../translations/zh_TW/arch/arm64/elf_hwcaps.rst | 2 +-
.../translations/zh_TW/arch/arm64/hugetlbpage.rst | 2 +-
.../translations/zh_TW/arch/arm64/index.rst | 2 +-
.../zh_TW/arch/arm64/legacy_instructions.txt | 4 +-
.../translations/zh_TW/arch/arm64/memory.txt | 4 +-
.../translations/zh_TW/arch/arm64/perf.rst | 2 +-
.../zh_TW/arch/arm64/silicon-errata.txt | 4 +-
.../zh_TW/arch/arm64/tagged-pointers.txt | 4 +-
.../translations/zh_TW/dev-tools/sparse.rst | 10 +-
.../zh_TW/dev-tools/testing-overview.rst | 2 +-
.../translations/zh_TW/disclaimer-zh_TW.rst | 2 +-
.../translations/zh_TW/filesystems/debugfs.rst | 2 +-
.../translations/zh_TW/filesystems/index.rst | 2 +-
.../translations/zh_TW/filesystems/sysfs.txt | 2 +-
.../translations/zh_TW/filesystems/virtiofs.rst | 2 +-
Documentation/translations/zh_TW/gpio.txt | 8 +-
Documentation/translations/zh_TW/index.rst | 2 +-
Documentation/translations/zh_TW/io_ordering.txt | 8 +-
.../translations/zh_TW/process/1.Intro.rst | 2 +-
.../translations/zh_TW/process/2.Process.rst | 2 +-
.../translations/zh_TW/process/3.Early-stage.rst | 2 +-
.../translations/zh_TW/process/4.Coding.rst | 2 +-
.../translations/zh_TW/process/5.Posting.rst | 2 +-
.../translations/zh_TW/process/6.Followthrough.rst | 2 +-
.../zh_TW/process/7.AdvancedTopics.rst | 2 +-
.../translations/zh_TW/process/8.Conclusion.rst | 2 +-
.../process/code-of-conduct-interpretation.rst | 2 +-
.../translations/zh_TW/process/code-of-conduct.rst | 2 +-
.../translations/zh_TW/process/coding-style.rst | 2 +-
.../zh_TW/process/development-process.rst | 6 +-
.../translations/zh_TW/process/email-clients.rst | 2 +-
.../zh_TW/process/embargoed-hardware-issues.rst | 2 +-
Documentation/translations/zh_TW/process/howto.rst | 2 +-
Documentation/translations/zh_TW/process/index.rst | 2 +-
.../zh_TW/process/kernel-driver-statement.rst | 2 +-
.../zh_TW/process/kernel-enforcement-statement.rst | 2 +-
.../translations/zh_TW/process/license-rules.rst | 2 +-
.../translations/zh_TW/process/magic-number.rst | 2 +-
.../zh_TW/process/management-style.rst | 2 +-
.../zh_TW/process/programming-language.rst | 2 +-
.../zh_TW/process/stable-api-nonsense.rst | 2 +-
.../zh_TW/process/stable-kernel-rules.rst | 2 +-
.../zh_TW/process/submit-checklist.rst | 2 +-
.../zh_TW/process/submitting-patches.rst | 2 +-
.../zh_TW/process/volatile-considered-harmful.rst | 2 +-
.../{driver-api => userspace-api}/dcdbas.rst | 0
Documentation/userspace-api/index.rst | 8 +-
.../{driver-api => userspace-api}/isapnp.rst | 8 +-
Documentation/userspace-api/media/cec/cec-api.rst | 7 +-
.../userspace-api/media/drivers/index.rst | 7 +-
Documentation/userspace-api/media/dvb/dvbapi.rst | 7 +-
Documentation/userspace-api/media/index.rst | 7 +-
.../media/mediactl/media-controller.rst | 7 +-
.../userspace-api/media/rc/remote_controllers.rst | 7 +-
Documentation/userspace-api/media/v4l/v4l2.rst | 7 +-
Documentation/userspace-api/tee.rst | 39 +
MAINTAINERS | 21 +-
drivers/platform/x86/dell/Kconfig | 2 +-
drivers/platform/x86/dell/dcdbas.c | 2 +-
drivers/pnp/isapnp/Kconfig | 2 +-
drivers/tee/optee/Kconfig | 2 +-
fs/vboxsf/vboxsf_wrappers.c | 2 +-
scripts/get_abi.pl | 3 +-
scripts/kernel-doc | 15 +-
scripts/sphinx-pre-install | 10 +-
153 files changed, 3206 insertions(+), 794 deletions(-)
create mode 100644 Documentation/driver-api/tee.rst
create mode 100644 Documentation/sphinx/templates/translations.html
create mode 100644 Documentation/sphinx/translations.py
delete mode 100644 Documentation/staging/tee.rst
create mode 100644 Documentation/tee/amd-tee.rst
create mode 100644 Documentation/tee/index.rst
create mode 100644 Documentation/tee/op-tee.rst
create mode 100644 Documentation/tee/tee.rst
create mode 100644 Documentation/translations/sp_SP/process/handling-regressions.rst
rename Documentation/translations/sp_SP/{ => process}/howto.rst (99%)
create mode 100644 Documentation/translations/sp_SP/process/management-style.rst
create mode 100644 Documentation/translations/sp_SP/process/submit-checklist.rst
create mode 100644 Documentation/translations/zh_CN/arch/riscv/boot.rst
create mode 100644 Documentation/translations/zh_CN/process/maintainer-pgp-guide.rst
rename Documentation/{driver-api => userspace-api}/dcdbas.rst (100%)
rename Documentation/{driver-api => userspace-api}/isapnp.rst (51%)
create mode 100644 Documentation/userspace-api/tee.rst