[GIT PULL] Documentation for 5.14
From: Jonathan Corbet
Date: Mon Jun 28 2021 - 11:50:36 EST
The following changes since commit 7240cd200541543008a7ce4fcaf2ba5a5556128f:
Remove link to nonexistent rocket driver docs (2021-05-11 11:02:39 -0600)
are available in the Git repository at:
git://git.lwn.net/linux.git tags/docs-5.14
for you to fetch changes up to 98cf4951842adbb03079dadedddf30b95e623cb0:
Merge branch 'path-lookup' into docs-next (2021-06-18 11:37:35 -0600)
----------------------------------------------------------------
This was a reasonably active cycle for documentation; this pull includes:
- Some kernel-doc cleanups. That script is still regex onslaught from
hell, but it has gotten a little better.
- Improvements to the checkpatch docs, which are also used by the tool
itself.
- A major update to the pathname lookup documentation.
- Elimination of :doc: markup, since our automarkup magic can create
references from filenames without all the extra noise.
- The flurry of Chinese translation activity continues.
Plus, of course, the usual collection of updates, typo fixes, and warning
fixes.
Expect a couple of minor conflicts as usual; the linux-next resolutions
are correct.
----------------------------------------------------------------
Aditya Srivastava (1):
scripts: kernel-doc: reduce repeated regex expressions into variables
Akira Yokosawa (2):
docs: Activate exCJK only in CJK chapters
docs: pdfdocs: Prevent column squeezing by tabulary
Andrew Jeffery (1):
Documentation: checkpatch: Tweak BIT() macro include
Baoquan He (1):
Documentation: kdump: update kdump guide
Barry Song (1):
docs: kernel-parameters: mark numa=off is supported by a bundle of architectures
Carlos Bilbao (1):
docs: typo fixes in Documentation/ABI/
Carlos Llamas (1):
docs: printk-formats: update size-casting examples
Chun-Hung Tseng (1):
Documentation: scheduler: fixed 2 typos in sched-nice-design.rst
Colin Ian King (1):
tools: Fix "the the" in a message in kernel-chktaint
Dwaipayan Ray (2):
docs: Add more message type documentations for checkpatch
docs: checkpatch: Document and segregate more checkpatch message types
Fox Chen (13):
docs: path-lookup: update follow_managed() part
docs: path-lookup: update path_to_nameidata() part
docs: path-lookup: update path_mountpoint() part
docs: path-lookup: update do_last() part
docs: path-lookup: remove filename_mountpoint
docs: path-lookup: Add macro name to symlink limit description
docs: path-lookup: i_op->follow_link replaced with i_op->get_link
docs: path-lookup: update i_op->put_link and cookie description
docs: path-lookup: no get_link()
docs: path-lookup: update WALK_GET, WALK_PUT desc
docs: path-lookup: update get_link() ->follow_link description
docs: path-lookup: update symlink description
docs: path-lookup: use bare function() rather than literals
Gao Mingfei (1):
docs: block: fix stat.rst document error
Hailong Liu (1):
docs/zh_CN: Add zh_CN/admin-guide/lockup-watchdogs.rst
Hao Chen (1):
Documentation: ACPI: fix error script name
Haocheng Xie (1):
docs: Fix typos in Documentation/trace/ftrace.rst
Igor Matheus Andrade Torrente (1):
docs: convert dax.txt to rst
Jonathan Corbet (3):
Merge branch 'mauro' into docs-next
docs: Take a little noise out of the build process
Merge branch 'path-lookup' into docs-next
Kees Cook (2):
docs: networking: Replace strncpy() with strscpy()
docs: Makefile: Use CONFIG_SHELL not SHELL
Kir Kolyshkin (1):
docs: fix a cross-ref
Mauro Carvalho Chehab (50):
docs: update sysfs-platform_profile.rst reference
docs: vcpu-requests.rst: fix reference for atomic ops
docs: translations/zh_CN: fix a typo at 8.Conclusion.rst
docs: sched-bwc.rst: fix a typo on a doc name
docs: update pin-control.rst references
docs: virt: api.rst: fix a pointer to SGX documentation
docs: ABI: iommu: remove duplicated definition for sysfs-kernel-iommu_groups
docs: ABI: sysfs-class-backlight: unify ambient light zone nodes
docs: ABI: sysfs-class-led-trigger-pattern: remove repeat duplication
iio: ABI: sysfs-bus-iio: fix a typo
iio: ABI: sysfs-bus-iio: avoid a warning when doc is built
scripts: sphinx-pre-install: rework the sphinx install logic
scripts: sphinx-pre-install: fix the need of virtenv packages
docs: admin-guide: reporting-issues.rst: replace some characters
docs: trace: coresight: coresight-etm4x-reference.rst: replace some characters
docs: driver-api: ioctl.rst: replace some characters
docs: usb: replace some characters
docs: vm: zswap.rst: replace some characters
docs: filesystems: ext4: blockgroup.rst: replace some characters
docs: networking: device_drivers: replace some characters
docs: PCI: Replace non-breaking spaces to avoid PDF issues
docs: devices.rst: better reference documentation docs
docs: dev-tools: kunit: don't use a table for docs name
docs: admin-guide: pm: avoid using ReST :doc:`foo` markup
docs: admin-guide: hw-vuln: avoid using ReST :doc:`foo` markup
docs: admin-guide: sysctl: avoid using ReST :doc:`foo` markup
docs: block: biodoc.rst: avoid using ReST :doc:`foo` markup
docs: bpf: bpf_lsm.rst: avoid using ReST :doc:`foo` markup
docs: core-api: avoid using ReST :doc:`foo` markup
docs: dev-tools: testing-overview.rst: avoid using ReST :doc:`foo` markup
docs: dev-tools: kunit: avoid using ReST :doc:`foo` markup
docs: devicetree: bindings: submitting-patches.rst: avoid using ReST :doc:`foo` markup
docs: doc-guide: avoid using ReST :doc:`foo` markup
docs: driver-api: avoid using ReST :doc:`foo` markup
docs: driver-api: gpio: using-gpio.rst: avoid using ReST :doc:`foo` markup
docs: driver-api: surface_aggregator: avoid using ReST :doc:`foo` markup
docs: driver-api: usb: avoid using ReST :doc:`foo` markup
docs: firmware-guide: acpi: avoid using ReST :doc:`foo` markup
docs: i2c: avoid using ReST :doc:`foo` markup
docs: kernel-hacking: hacking.rst: avoid using ReST :doc:`foo` markup
docs: networking: devlink: avoid using ReST :doc:`foo` markup
docs: PCI: endpoint: pci-endpoint-cfs.rst: avoid using ReST :doc:`foo` markup
docs: PCI: pci.rst: avoid using ReST :doc:`foo` markup
docs: process: submitting-patches.rst: avoid using ReST :doc:`foo` markup
docs: security: landlock.rst: avoid using ReST :doc:`foo` markup
docs: trace: coresight: coresight.rst: avoid using ReST :doc:`foo` markup
docs: trace: ftrace.rst: avoid using ReST :doc:`foo` markup
docs: userspace-api: landlock.rst: avoid using ReST :doc:`foo` markup
docs: virt: kvm: s390-pv-boot.rst: avoid using ReST :doc:`foo` markup
docs: x86: avoid using ReST :doc:`foo` markup
Nobuhiro Iwamatsu (1):
docs: Fix typo in Documentation/arm/marvell.rst
Rasmus Villemoes (1):
docs: admin-guide: update description for kernel.hotplug sysctl
Rob Herring (1):
documentation-file-ref-check: Make git check work for multiple working directories
Tian Tao (1):
docs: cputopology: move the sysfs ABI description to right place
Tiezhu Yang (2):
samples/kprobes: Fix typo in handler_fault()
samples/kprobes: Fix typo in handler_post()
Wan Jiabing (1):
docs/zh_CN: add translations in zh_CN/dev-tools/kasan
Wei Ming Chen (2):
docs: usb: function: Modify path name
docs: Use fallthrough pseudo-keyword
Wolfram Sang (1):
docs: fault-injection: fix non-working usage of negative values
Wu XiangCheng (6):
docs/zh_CN: Add translation zh_CN/maintainer/index.rst
docs/zh_CN: Add translation zh_CN/maintainer/configure-git.rst
docs/zh_CN: Add translation zh_CN/maintainer/rebasing-and-merging.rst
docs/zh_CN: Add translation zh_CN/maintainer/pull-requests.rst
docs/zh_CN: Add translation zh_CN/maintainer/maintainer-entry-profile.rst
docs/zh_CN: Add translation zh_CN/maintainer/modifying-patches.rst
Yanteng Si (14):
docs/zh_CN: add core-api kernel-api.rst translation
docs/zh_CN: add core-api printk-basics.rst translation
docs/zh_CN: add core-api printk-formats.rst translation
docs/zh_CN: add core-api workqueue.rst translation
docs/zh_CN: add core api kobject translation
docs/zh_CN: add parisc index translation
docs/zh_CN: add parisc debugging.rst translation
docs/zh_CN: add parisc registers.rst translation
docs/zh_CN:add core-api refcount-vs-atomic.rst translation.
docs/zh_CN: add core api local_ops.rst translation
docs: zh_CN: update Chinese translations
docs/zh_CN: add core-api symbol-namespaces.rst translation
docs/zh_CN:add core-api padata translation
docs/zh_CN: add core api cachetlb translation
Yue Hu (1):
docs: block: blk-mq.rst: correct drive -> driver
Documentation/ABI/obsolete/sysfs-cpuidle | 2 +-
Documentation/ABI/removed/sysfs-kernel-uids | 2 +-
Documentation/ABI/stable/sysfs-bus-vmbus | 2 +-
Documentation/ABI/stable/sysfs-bus-xen-backend | 2 +-
Documentation/ABI/stable/sysfs-devices-system-cpu | 83 +++
Documentation/ABI/stable/sysfs-driver-dma-idxd | 2 +-
Documentation/ABI/stable/sysfs-driver-mlxreg-io | 4 +-
Documentation/ABI/testing/configfs-iio | 2 +-
Documentation/ABI/testing/configfs-most | 8 +-
Documentation/ABI/testing/configfs-usb-gadget | 2 +-
Documentation/ABI/testing/configfs-usb-gadget-uvc | 4 +-
Documentation/ABI/testing/debugfs-driver-genwqe | 2 +-
.../ABI/testing/debugfs-driver-habanalabs | 2 +-
Documentation/ABI/testing/sysfs-bus-fsi | 2 +-
Documentation/ABI/testing/sysfs-bus-iio | 6 +-
Documentation/ABI/testing/sysfs-bus-pci | 4 +-
Documentation/ABI/testing/sysfs-class-backlight | 100 ++++
.../ABI/testing/sysfs-class-backlight-adp5520 | 31 --
.../ABI/testing/sysfs-class-backlight-adp8860 | 37 --
.../testing/sysfs-class-backlight-driver-adp8870 | 32 --
.../ABI/testing/sysfs-class-led-driver-el15203000 | 9 -
.../ABI/testing/sysfs-class-led-trigger-pattern | 3 +
Documentation/ABI/testing/sysfs-devices-system-cpu | 10 +-
Documentation/ABI/testing/sysfs-driver-ufs | 4 +-
Documentation/ABI/testing/sysfs-fs-f2fs | 2 +-
.../ABI/testing/sysfs-kernel-iommu_groups | 12 +-
Documentation/Makefile | 2 +-
Documentation/PCI/acpi-info.rst | 18 +-
Documentation/PCI/endpoint/pci-endpoint-cfs.rst | 2 +-
Documentation/PCI/pci.rst | 6 +-
Documentation/admin-guide/cputopology.rst | 85 +--
Documentation/admin-guide/ext4.rst | 2 +-
.../special-register-buffer-data-sampling.rst | 3 +-
Documentation/admin-guide/kdump/kdump.rst | 170 +++---
Documentation/admin-guide/kernel-parameters.txt | 3 +
Documentation/admin-guide/pm/intel_idle.rst | 16 +-
Documentation/admin-guide/pm/intel_pstate.rst | 9 +-
Documentation/admin-guide/reporting-issues.rst | 2 +-
Documentation/admin-guide/sysctl/abi.rst | 2 +-
Documentation/admin-guide/sysctl/kernel.rst | 44 +-
Documentation/arm/marvell.rst | 2 +-
Documentation/block/biodoc.rst | 2 +-
Documentation/block/blk-mq.rst | 4 +-
Documentation/block/stat.rst | 2 +-
Documentation/bpf/bpf_lsm.rst | 13 +-
Documentation/conf.py | 24 +-
Documentation/core-api/bus-virt-phys-mapping.rst | 2 +-
Documentation/core-api/dma-api.rst | 5 +-
Documentation/core-api/dma-isa-lpc.rst | 2 +-
Documentation/core-api/index.rst | 4 +-
Documentation/core-api/printk-formats.rst | 9 +-
Documentation/dev-tools/checkpatch.rst | 509 ++++++++++++++++--
Documentation/dev-tools/kunit/api/index.rst | 8 +-
Documentation/dev-tools/kunit/faq.rst | 2 +-
Documentation/dev-tools/kunit/index.rst | 14 +-
Documentation/dev-tools/kunit/start.rst | 4 +-
Documentation/dev-tools/kunit/tips.rst | 5 +-
Documentation/dev-tools/kunit/usage.rst | 8 +-
Documentation/dev-tools/testing-overview.rst | 18 +-
.../devicetree/bindings/submitting-patches.rst | 11 +-
Documentation/doc-guide/contributing.rst | 8 +-
Documentation/driver-api/acpi/linuxized-acpica.rst | 2 +-
Documentation/driver-api/gpio/using-gpio.rst | 4 +-
Documentation/driver-api/ioctl.rst | 10 +-
Documentation/driver-api/pm/devices.rst | 8 +-
.../surface_aggregator/clients/index.rst | 3 +-
.../driver-api/surface_aggregator/internal.rst | 15 +-
.../driver-api/surface_aggregator/overview.rst | 6 +-
Documentation/driver-api/usb/dma.rst | 6 +-
Documentation/fault-injection/fault-injection.rst | 24 +-
Documentation/filesystems/dax.rst | 291 ++++++++++
Documentation/filesystems/dax.txt | 257 ---------
Documentation/filesystems/ext2.rst | 2 +-
Documentation/filesystems/ext4/blockgroup.rst | 2 +-
Documentation/filesystems/index.rst | 1 +
Documentation/filesystems/path-lookup.rst | 194 +++----
.../acpi/dsd/data-node-references.rst | 3 +-
Documentation/firmware-guide/acpi/dsd/graph.rst | 2 +-
Documentation/firmware-guide/acpi/enumeration.rst | 7 +-
Documentation/i2c/instantiating-devices.rst | 2 +-
Documentation/i2c/old-module-parameters.rst | 3 +-
Documentation/i2c/smbus-protocol.rst | 4 +-
Documentation/input/joydev/joystick-api.rst | 2 +-
Documentation/kernel-hacking/hacking.rst | 4 +-
.../device_drivers/ethernet/intel/i40e.rst | 6 +-
.../device_drivers/ethernet/intel/iavf.rst | 2 +-
.../networking/devlink/devlink-region.rst | 2 +-
Documentation/networking/devlink/devlink-trap.rst | 4 +-
Documentation/networking/packet_mmap.rst | 2 +-
Documentation/networking/tuntap.rst | 2 +-
Documentation/process/submitting-patches.rst | 32 +-
Documentation/scheduler/sched-bwc.rst | 2 +-
Documentation/scheduler/sched-nice-design.rst | 2 +-
Documentation/security/landlock.rst | 3 +-
.../trace/coresight/coresight-etm4x-reference.rst | 2 +-
Documentation/trace/coresight/coresight.rst | 8 +-
Documentation/trace/ftrace.rst | 6 +-
Documentation/translations/index.rst | 4 +
Documentation/translations/it_IT/index.rst | 4 +
.../translations/it_IT/process/coding-style.rst | 2 +-
Documentation/translations/ja_JP/index.rst | 5 +-
Documentation/translations/ko_KR/index.rst | 5 +-
.../translations/zh_CN/admin-guide/index.rst | 2 +-
.../zh_CN/admin-guide/lockup-watchdogs.rst | 66 +++
.../translations/zh_CN/core-api/cachetlb.rst | 336 ++++++++++++
.../translations/zh_CN/core-api/index.rst | 24 +-
.../translations/zh_CN/core-api/kernel-api.rst | 369 +++++++++++++
.../translations/zh_CN/core-api/kobject.rst | 378 +++++++++++++
.../translations/zh_CN/core-api/local_ops.rst | 194 +++++++
.../translations/zh_CN/core-api/padata.rst | 158 ++++++
.../translations/zh_CN/core-api/printk-basics.rst | 110 ++++
.../translations/zh_CN/core-api/printk-formats.rst | 595 +++++++++++++++++++++
.../zh_CN/core-api/refcount-vs-atomic.rst | 154 ++++++
.../zh_CN/core-api/symbol-namespaces.rst | 142 +++++
.../translations/zh_CN/core-api/workqueue.rst | 337 ++++++++++++
.../translations/zh_CN/dev-tools/index.rst | 2 +-
.../translations/zh_CN/dev-tools/kasan.rst | 417 +++++++++++++++
Documentation/translations/zh_CN/index.rst | 5 +-
.../zh_CN/maintainer/configure-git.rst | 62 +++
.../translations/zh_CN/maintainer/index.rst | 21 +
.../zh_CN/maintainer/maintainer-entry-profile.rst | 92 ++++
.../zh_CN/maintainer/modifying-patches.rst | 51 ++
.../zh_CN/maintainer/pull-requests.rst | 148 +++++
.../zh_CN/maintainer/rebasing-and-merging.rst | 165 ++++++
.../translations/zh_CN/parisc/debugging.rst | 42 ++
Documentation/translations/zh_CN/parisc/index.rst | 28 +
.../translations/zh_CN/parisc/registers.rst | 153 ++++++
.../translations/zh_CN/process/8.Conclusion.rst | 2 +-
.../translations/zh_CN/process/coding-style.rst | 2 +-
Documentation/usb/ehci.rst | 2 +-
Documentation/usb/gadget_configfs.rst | 2 +-
Documentation/usb/gadget_printer.rst | 2 +-
Documentation/userspace-api/landlock.rst | 11 +-
Documentation/virt/kvm/api.rst | 2 +-
Documentation/virt/kvm/s390-pv-boot.rst | 2 +-
Documentation/virt/kvm/vcpu-requests.rst | 2 +-
Documentation/vm/zswap.rst | 4 +-
Documentation/x86/boot.rst | 4 +-
Documentation/x86/mtrr.rst | 2 +-
include/linux/device.h | 2 +-
include/linux/mfd/madera/pdata.h | 2 +-
include/linux/pinctrl/pinconf-generic.h | 2 +-
include/linux/platform_profile.h | 2 +-
samples/kprobes/kprobe_example.c | 33 +-
scripts/documentation-file-ref-check | 2 +-
scripts/kernel-doc | 71 ++-
scripts/sphinx-pre-install | 262 ++++++---
tools/debugging/kernel-chktaint | 2 +-
148 files changed, 5722 insertions(+), 1078 deletions(-)
delete mode 100644 Documentation/ABI/testing/sysfs-class-backlight-adp5520
delete mode 100644 Documentation/ABI/testing/sysfs-class-backlight-adp8860
delete mode 100644 Documentation/ABI/testing/sysfs-class-backlight-driver-adp8870
delete mode 100644 Documentation/ABI/testing/sysfs-class-led-driver-el15203000
create mode 100644 Documentation/filesystems/dax.rst
delete mode 100644 Documentation/filesystems/dax.txt
create mode 100644 Documentation/translations/zh_CN/admin-guide/lockup-watchdogs.rst
create mode 100644 Documentation/translations/zh_CN/core-api/cachetlb.rst
create mode 100644 Documentation/translations/zh_CN/core-api/kernel-api.rst
create mode 100644 Documentation/translations/zh_CN/core-api/kobject.rst
create mode 100644 Documentation/translations/zh_CN/core-api/local_ops.rst
create mode 100644 Documentation/translations/zh_CN/core-api/padata.rst
create mode 100644 Documentation/translations/zh_CN/core-api/printk-basics.rst
create mode 100644 Documentation/translations/zh_CN/core-api/printk-formats.rst
create mode 100644 Documentation/translations/zh_CN/core-api/refcount-vs-atomic.rst
create mode 100644 Documentation/translations/zh_CN/core-api/symbol-namespaces.rst
create mode 100644 Documentation/translations/zh_CN/core-api/workqueue.rst
create mode 100644 Documentation/translations/zh_CN/dev-tools/kasan.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/configure-git.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/index.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/maintainer-entry-profile.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/modifying-patches.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/pull-requests.rst
create mode 100644 Documentation/translations/zh_CN/maintainer/rebasing-and-merging.rst
create mode 100644 Documentation/translations/zh_CN/parisc/debugging.rst
create mode 100644 Documentation/translations/zh_CN/parisc/index.rst
create mode 100644 Documentation/translations/zh_CN/parisc/registers.rst