The following changes since commit 568035b01cfb107af8d2e4bd2fb9aea22cf5b868: Linux 6.0-rc1 (2022-08-14 15:50:18 -0700) are available in the Git repository at: git://git.lwn.net/linux.git tags/docs-6.1 for you to fetch changes up to 69d517e6e21099f81efbd39e47874649ae575804: checkpatch: warn on usage of VM_BUG_ON() and other BUG variants (2022-09-29 13:20:53 -0600) ---------------------------------------------------------------- There's not a huge amount of activity in the docs tree this time around, but a few significant changes even so: - A complete rewriting of the top-level index.rst file, which mostly reflects itself in a redone top page in the HTML-rendered docs. The hope is that the new organization will be a friendlier starting point for both users and developers. - Some math-rendering improvements. - A coding-style.rst update on the use of BUG() and WARN() - A big maintainer-PHP guide update. - Some code-of-conduct updates - More Chinese translation work Plus the usual pile of typo fixes, corrections, and updates. CONFLICTS: a Documentation/index.rst thrash could be expected to create a lot of conflicts, but there seems to be just one: with the Rust tree. Resolution is to take the docs version but add "rust/index" after "livepatch/index". There's also a small conflict with the RCU tree; just take the RCU side there. ---------------------------------------------------------------- Akhil Raj (2): Remove duplicate words inside documentation Delete duplicate words from kernel docs Akira Yokosawa (3): docs/conf.py: Treat mathjax as fallback math renderer docs/conf.py: Respect env variable SPHINX_IMGMATH docs/doc-guide: Add documentation on SPHINX_IMGMATH Binbin Zhou (4): docs/zh_CN: core-api: Add idr Chinese translation docs/zh_CN: core-api: Add circular-buffers Chinese translation docs/zh_CN: core-api: Add generic-radix-tree Chinese translation docs/zh_CN: core-api: Add packing Chinese translation David Hildenbrand (2): coding-style.rst: document BUG() and WARN() rules ("do not crash the kernel") checkpatch: warn on usage of VM_BUG_ON() and other BUG variants Eric Lin (1): Documentation: irqdomain: Fix typo of "at least once" Hoi Pok Wu (1): docs: hugetlbpage.rst: fix a typo of hugepage size Jonathan Corbet (8): docs: promote the title of process/index.rst docs: Rewrite the front page docs: reconfigure the HTML left column docs: remove some index.rst cruft docs: move asm-annotations.rst into core-api docs: put atomic*.txt and memory-barriers.txt into the core-api book docs: add a man-pages link to the front page Merge branch 'fp' into docs-mw JunChao Sun (1): Documentation: ext4: correct the document about superblock Konstantin Ryabitsev (5): maintainer-pgp-guide: use key terminology consistent with upstream maintainer-pgp-guide: remove keyserver instructions maintainer-pgp-guide: update ECC support information maintainer-pgp-guide: add a section on PGP-signed patches maintainer-pgp-guide: minor wording tweaks Kristen Carlson Accardi (1): Documentation/CoC: Reflect current CoC interpretation and practices Lin Yujun (1): Documentation/hw-vuln: Update spectre doc Lukas Bulwahn (2): docs: admin-guide: do not mention the 'run a.out user programs' feature docs: admin-guide: for kernel bugs refer to other kernel documentation Lukasz Luba (1): docs: scheduler: Update new path for the sysctl knobs Randy Dunlap (6): Documentation/ABI: correct possessive "its" typos Documentation: filesystems: correct possessive "its" Documentation: spufs: correct a duplicate word typo Documentation: fb: udlfb: clean up text and formatting Documentation: W1: minor typo corrections usb: chipidea: clarify Documentation/ABI text Robert Elliott (1): docs/core-api: expand Fedora instructions for GCC plugins Rong Tao (1): Documentation: process/submitting-patches: misspelling "mesages" Salvatore Bonaccorso (1): Documentation: stable: Document alternative for referring upstream commit hash Shuah Khan (1): docs: update mediator information in CoC docs Thorsten Leemhuis (1): docs: process/5.Posting.rst: clarify use of Reported-by: tag Tiezhu Yang (1): docs, kprobes: Fix the wrong location of Kprobes Tuo Cao (1): docs: x86: replace do_IRQ int the entry_64.rst with common_interrupt() Vernon Yang (1): Documentation/mm: modify page_referenced to folio_referenced Wu XiangCheng (7): docs/zh_CN: Update zh_CN/process/email-clients.rst to 5.19 docs/zh_CN: Update zh_CN/process/submitting-patches.rst to 5.19 docs/zh_CN: Fix two missing labels in zh_CN/process docs/zh_CN: Update zh_CN/process/submit-checklist.rst to 6.0-rc2 docs/zh_CN: Update zh_CN/process/coding-style.rst to 6.0-rc2 docs/zh_CN: Update zh_CN/admin-guide/README.rst to 6.0-rc2 docs/zh_CN: Add new translation of admin-guide/bootconfig.rst Yang Yingliang (4): Documentation: devres: add missing PINCTRL helpers Documentation: devres: add missing SPI helper Documentation: devres: update IRQ helper Documentation: devres: add missing IO helper Yanteng Si (9): docs/zh_CN: Update the translation of gpio to 6.0-rc1 docs/zh_CN: Update the translation of io_ordering to 6.0-rc2 docs/zh_CN: Remove IRQ and oops-tracing docs/zh_TW: Remove oops-tracing docs/zh_CN: add PCI acpi-info translation docs/zh_CN: add dt changesets translation docs/zh_CN: add dt dynamic-resolution-notes translation docs/zh_CN: add dt overlay-notes translation docs/zh_CN: add dt kernel-api translation Zhao Mengmeng (1): Documentation: filesystems: xfs: update pseudocode and typo fixes Documentation/ABI/testing/sysfs-bus-bcma | 2 +- Documentation/ABI/testing/sysfs-bus-fcoe | 2 +- Documentation/ABI/testing/sysfs-bus-iio-proximity | 2 +- Documentation/ABI/testing/sysfs-devices-system-cpu | 2 +- .../ABI/testing/sysfs-platform-chipidea-usb2 | 6 +- Documentation/ABI/testing/sysfs-power | 2 +- Documentation/RCU/checklist.rst | 2 +- Documentation/RCU/lockdep.rst | 2 +- Documentation/admin-guide/README.rst | 91 +-- Documentation/admin-guide/hw-vuln/spectre.rst | 1 + Documentation/admin-guide/kdump/vmcoreinfo.rst | 2 +- Documentation/admin-guide/mm/hugetlbpage.rst | 2 +- Documentation/bpf/instruction-set.rst | 2 +- Documentation/bpf/map_cgroup_storage.rst | 4 +- Documentation/conf.py | 42 +- Documentation/{ => core-api}/asm-annotations.rst | 7 +- Documentation/core-api/cpu_hotplug.rst | 2 +- Documentation/core-api/index.rst | 4 + Documentation/core-api/irq/irq-domain.rst | 2 +- Documentation/core-api/wrappers/atomic_bitops.rst | 18 + Documentation/core-api/wrappers/atomic_t.rst | 19 + .../core-api/wrappers/memory-barriers.rst | 18 + Documentation/doc-guide/sphinx.rst | 57 +- Documentation/driver-api/driver-model/devres.rst | 7 +- Documentation/driver-api/isa.rst | 2 +- Documentation/fb/udlfb.rst | 23 +- Documentation/filesystems/caching/backend-api.rst | 2 +- Documentation/filesystems/ext4/super.rst | 6 +- Documentation/filesystems/f2fs.rst | 5 +- Documentation/filesystems/idmappings.rst | 2 +- Documentation/filesystems/qnx6.rst | 2 +- Documentation/filesystems/spufs/spufs.rst | 2 +- .../filesystems/xfs-delayed-logging-design.rst | 18 +- Documentation/index.rst | 156 ++--- Documentation/kbuild/gcc-plugins.rst | 19 +- Documentation/locking/seqlock.rst | 2 +- Documentation/mm/unevictable-lru.rst | 6 +- Documentation/process/5.Posting.rst | 6 +- .../process/code-of-conduct-interpretation.rst | 26 +- Documentation/process/coding-style.rst | 62 ++ Documentation/process/index.rst | 1 + Documentation/process/maintainer-pgp-guide.rst | 286 ++++----- Documentation/process/stable-kernel-rules.rst | 6 + Documentation/process/submitting-patches.rst | 4 +- Documentation/scheduler/sched-design-CFS.rst | 2 +- Documentation/staging/index.rst | 42 -- Documentation/subsystem-apis.rst | 58 ++ Documentation/trace/histogram.rst | 2 +- Documentation/trace/kprobes.rst | 4 +- Documentation/trace/timerlat-tracer.rst | 2 +- Documentation/translations/zh_CN/IRQ.txt | 39 -- Documentation/translations/zh_CN/PCI/acpi-info.rst | 139 ++++ Documentation/translations/zh_CN/PCI/index.rst | 13 +- .../translations/zh_CN/admin-guide/README.rst | 101 +-- .../translations/zh_CN/admin-guide/bootconfig.rst | 293 +++++++++ .../translations/zh_CN/admin-guide/index.rst | 2 +- .../zh_CN/core-api/circular-buffers.rst | 210 ++++++ .../zh_CN/core-api/generic-radix-tree.rst | 23 + Documentation/translations/zh_CN/core-api/idr.rst | 80 +++ .../translations/zh_CN/core-api/index.rst | 8 +- .../translations/zh_CN/core-api/packing.rst | 160 +++++ .../translations/zh_CN/devicetree/changesets.rst | 37 ++ .../zh_CN/devicetree/dynamic-resolution-notes.rst | 31 + .../translations/zh_CN/devicetree/index.rst | 13 +- .../translations/zh_CN/devicetree/kernel-api.rst | 58 ++ .../zh_CN/devicetree/overlay-notes.rst | 140 ++++ .../translations/zh_CN/driver-api/gpio/index.rst | 69 ++ .../zh_CN/{gpio.txt => driver-api/gpio/legacy.rst} | 184 ++++-- .../translations/zh_CN/driver-api/index.rst | 132 ++++ .../translations/zh_CN/driver-api/io_ordering.rst | 60 ++ Documentation/translations/zh_CN/index.rst | 4 +- Documentation/translations/zh_CN/io_ordering.txt | 67 -- Documentation/translations/zh_CN/oops-tracing.txt | 212 ------ .../translations/zh_CN/process/coding-style.rst | 274 +++++--- .../translations/zh_CN/process/email-clients.rst | 265 +++++--- .../zh_CN/process/submit-checklist.rst | 84 +-- .../zh_CN/process/submitting-patches.rst | 714 ++++++++++----------- .../zh_CN/scheduler/sched-design-CFS.rst | 2 +- Documentation/translations/zh_TW/oops-tracing.txt | 212 ------ Documentation/virt/kvm/x86/mmu.rst | 2 +- Documentation/w1/masters/ds2490.rst | 2 +- Documentation/w1/w1-generic.rst | 2 +- Documentation/x86/entry_64.rst | 4 +- scripts/checkpatch.pl | 8 +- 84 files changed, 2957 insertions(+), 1731 deletions(-) rename Documentation/{ => core-api}/asm-annotations.rst (97%) create mode 100644 Documentation/core-api/wrappers/atomic_bitops.rst create mode 100644 Documentation/core-api/wrappers/atomic_t.rst create mode 100644 Documentation/core-api/wrappers/memory-barriers.rst create mode 100644 Documentation/subsystem-apis.rst delete mode 100644 Documentation/translations/zh_CN/IRQ.txt create mode 100644 Documentation/translations/zh_CN/PCI/acpi-info.rst create mode 100644 Documentation/translations/zh_CN/admin-guide/bootconfig.rst create mode 100644 Documentation/translations/zh_CN/core-api/circular-buffers.rst create mode 100644 Documentation/translations/zh_CN/core-api/generic-radix-tree.rst create mode 100644 Documentation/translations/zh_CN/core-api/idr.rst create mode 100644 Documentation/translations/zh_CN/core-api/packing.rst create mode 100644 Documentation/translations/zh_CN/devicetree/changesets.rst create mode 100644 Documentation/translations/zh_CN/devicetree/dynamic-resolution-notes.rst create mode 100644 Documentation/translations/zh_CN/devicetree/kernel-api.rst create mode 100644 Documentation/translations/zh_CN/devicetree/overlay-notes.rst create mode 100644 Documentation/translations/zh_CN/driver-api/gpio/index.rst rename Documentation/translations/zh_CN/{gpio.txt => driver-api/gpio/legacy.rst} (89%) create mode 100644 Documentation/translations/zh_CN/driver-api/index.rst create mode 100644 Documentation/translations/zh_CN/driver-api/io_ordering.rst delete mode 100644 Documentation/translations/zh_CN/io_ordering.txt delete mode 100644 Documentation/translations/zh_CN/oops-tracing.txt delete mode 100644 Documentation/translations/zh_TW/oops-tracing.txt