[GIT PULL] Documentation for 5.10
From: Jonathan Corbet
Date: Mon Oct 12 2020 - 15:30:45 EST
The following changes since commit
92001bc0365a144783f8f3108be94e74baf61011:
Documentation: laptops: thinkpad-acpi: fix underline length build warning (2020-08-24 17:19:07 -0600)
are available in the Git repository at:
git://git.lwn.net/linux.git tags/docs-5.10
for you to fetch changes up to 4fb220da0dd03d3699776220d86ac84b38941c0c:
gpiolib: Update indentation in driver.rst for code excerpts (2020-10-12 13:15:34 -0600)
----------------------------------------------------------------
As hoped, things calmed down for docs this cycle; fewer changes and almost
no conflicts at all. This pull includes:
- A reworked and expanded user-mode Linux document
- Some simplifications and improvements for submitting-patches.rst
- An emergency fix for (some) problems with Sphinx 3.x
- Some welcome automarkup improvements to automatically generate
cross-references to struct definitions and other documents
- The usual collection of translation updates, typo fixes, etc.
NOTE that there will be a largish late-window pull request coming,
probably directly from Mauro. Sphinx 3.x has broken a bunch of things,
which is obnoxious, though the end result is better; fixing the problems
requires a number of cross-tree documentation tweaks. These are best done
toward the end to avoid creating unnecessary conflicts with other trees.
----------------------------------------------------------------
Andrew Cooper (1): docs/ia64: Drop obsolete Xen documentation
Andy Shevchenko (1):
gpiolib: Update indentation in driver.rst for code excerpts
Anton Ivanov (1):
docs: replace the old User Mode Linux HowTo with a new one
Bailu Lin (2):
doc: zh_CN: index files in arm64 subdirectory
Documentation: Chinese translation of Documentation/arm64/amu.rst
Barry Song (1):
Documentation: core-api/cpu_hotplug: fix a typo
Bhaskar Chowdhury (4):
docs: fb: Remove framebuffer scrollback boot option
docs: fb: Remove matroxfb scrollback boot option
docs: fb: Remove sstfb scrollback boot option
docs: fb: Remove vesafb scrollback boot option
Coly Li (2):
docs: trusted-encrypted.rst: update parameters for command examples
bcache: doc: update Documentation/admin-guide/bcache.rst
Connor Kuehl (1):
docs: kvm: fix referenced ioctl symbol
Dave Hansen (1):
Documentation: clarify driver licensing rules
Denis Efremov (2):
Documentation: remove current_security() reference
docs: filesystems: replace to_dev() with kobj_to_dev()
Drew DeVault (4):
submitting-patches.rst: remove heading numbering
Documentation/process: expand plain-text advice
Documentation/maintainer: rehome sign-off process
submitting-patches.rst: presume git will be used
Gustavo A. R. Silva (1):
docs: deprecated.rst: Update zero-length/one-element arrays section
Javier Garcia (1):
Documentation: process: step 2: Link to email list fixed.
Joe Perches (1):
deprecated.rst: Remove now removed uninitialized_var
John Hubbard (1):
Documentation: better locations for sysfs-pci, sysfs-tagging
Jonathan Cameron (1):
kernel-doc: add support for ____cacheline_aligned attribute
Jonathan Corbet (1):
Make the docs build "work" with Sphinx 3.x
Jonathan Neuschäfer (2):
MAINTAINERS: Add ubifs-authentication.rst to UBIFS
docs: ubifs-authentication: Add a top-level heading
Krzysztof Kozlowski (1):
docs: process: Add cross-link to security-bugs
Lars Poeschel (1):
Documentation: iio: fix a typo
Li Qiang (1):
Documentation: kvm: fix a typo
Mark Starovoytov (1):
mailmap: add entry for <mstarovoitov@xxxxxxxxxxx>
Mauro Carvalho Chehab (14):
.gitignore: docs: ignore sphinx_*/ directories
kernel-doc: include line numbers for function prototypes
docs: scheduler: fix the directory name on two files
docs: trace: fix the location of kprobes.rst
MAINTAINERS: fix location of qlogic/LICENSE.qla3xxx
scripts: device_attr_show.cocci: update location of sysfs doc
docs: add some new files to their respective index.rst files
docs: watch_queue: fix some warnings
docs: kvm: api.rst: add missing spaces
docs: soundwire: fix some identation at stream.rst
docs: dma-buf: fix some warnings
docs: submitting-patches: use :doc: for references
iio: iio.h: fix a warning at the kernel-doc markup
docs: trace: ring-buffer-design.rst: use the new SPDX tag
Naoki Hayama (1):
Documentation/admin-guide: tainted-kernels: Fix typo occured
NeilBrown (1):
doc: seq_file: clarify role of *pos in ->next()
Nick Desaulniers (2):
Documentation: add minimum clang/llvm version
docs: programming-languages: refresh blurb on clang support
Nícolas F. R. A. Prado (5):
docs: Add automatic cross-reference for C types
kernel-doc: Update "cross-referencing from rST" section to use automarkup
docs: Allow multiple automarkup functions
docs: Add automatic cross-reference for documentation pages
docs: Document cross-referencing between documentation pages
Ralph Campbell (2):
mm/doc: editorial pass on page migration
mm/doc: add usage description for migrate_vma_*()
Randy Dunlap (10):
Documentation: submit-checklist: add clean builds for new Documentation
Documentation: filesystems: mount_api: fix headings
Documentation: kernel-parameters: fix formatting of MIPS "machtype"
Documentation/admin-guide: kernel-parameters: fix "disable_ddw" wording
Documentation/admin-guide: kernel-parameters: fix "io7" parameter description
Documentation: admin-guide: kernel-parameters: reformat "lapic=" boot option
Documentation/admin-guide: kernel-parameters: capitalize Korina
Documentation/admin-guide: README & svga: remove use of "rdev"
Documentation/admin-guide: blockdev/ramdisk: remove use of "rdev"
Documentation: kernel-parameters: clarify "module." parameters
Satheesh Rajendran (1):
Doc: admin-guide: Add entry for kvm_cma_resv_ratio kernel param
SeongJae Park (5):
Documentation/kokr: bring process docs up to date
Documentation/kokr/howto: Wordsmith
docs/memory-barriers.txt: Fix references for DMA*.txt files
docs/memory-barriers.txt/kokr: Remove remaining references to mmiowb()
docs/memory-barriers.txt/kokr: Allow architecture to override the flush barrier
Stephen Boyd (1):
docs: stable-ABI: Document /sys/kernel/notes
Stephen Kitt (3):
docs: rewrite admin-guide/sysctl/abi.rst
docs: rewrite admin-guide/sysctl/abi.rst
Fix references to nommu-mmap.rst
Tian Tao (2):
Documentation: arm64 also supports disable hugeiomap
Documentation: Remove CMA's dependency on architecture
Wilken Gottwalt (1):
documentation: arm: sunxi: Allwinner H2+/H3 update
lijiang (1):
docs: admin-guide: update kdump documentation due to change of crash URL
.gitignore | 3 +
.mailmap | 1 +
Documentation/ABI/stable/sysfs-kernel-notes | 5 +
Documentation/PCI/index.rst | 1 +
Documentation/{filesystems => PCI}/sysfs-pci.rst | 0
Documentation/admin-guide/README.rst | 6 +-
Documentation/admin-guide/bcache.rst | 31 +-
Documentation/admin-guide/blockdev/ramdisk.rst | 66 +-
Documentation/admin-guide/cgroup-v1/cpusets.rst | 2 +
Documentation/admin-guide/kdump/kdump.rst | 7 +-
Documentation/admin-guide/kernel-parameters.txt | 38 +-
Documentation/admin-guide/svga.rst | 7 +-
Documentation/admin-guide/sysctl/abi.rst | 73 +-
Documentation/admin-guide/tainted-kernels.rst | 2 +-
Documentation/arm/sunxi.rst | 2 +-
Documentation/arm64/amu.rst | 2 +
Documentation/arm64/index.rst | 2 +
Documentation/conf.py | 15 +-
Documentation/core-api/cpu_hotplug.rst | 2 +-
Documentation/doc-guide/kernel-doc.rst | 33 +-
Documentation/doc-guide/sphinx.rst | 17 +
Documentation/driver-api/dma-buf.rst | 2 +-
Documentation/driver-api/gpio/driver.rst | 12 +-
Documentation/driver-api/nvdimm/index.rst | 1 +
Documentation/driver-api/soundwire/stream.rst | 8 +-
Documentation/fb/fbcon.rst | 21 +-
Documentation/fb/matroxfb.rst | 2 -
Documentation/fb/sstfb.rst | 3 -
Documentation/fb/vesafb.rst | 2 -
Documentation/filesystems/index.rst | 2 -
Documentation/filesystems/mount_api.rst | 7 +-
Documentation/filesystems/seq_file.rst | 20 +-
Documentation/filesystems/sysfs.rst | 3 +-
Documentation/filesystems/ubifs-authentication.rst | 6 +-
Documentation/firmware-guide/acpi/index.rst | 1 +
Documentation/hwmon/index.rst | 1 +
Documentation/ia64/index.rst | 1 -
Documentation/ia64/xen.rst | 206 -
Documentation/iio/iio_configfs.rst | 2 +-
Documentation/kbuild/llvm.rst | 4 +
Documentation/maintainer/index.rst | 1 +
Documentation/maintainer/modifying-patches.rst | 50 +
Documentation/memory-barriers.txt | 8 +-
Documentation/networking/index.rst | 1 +
.../{filesystems => networking}/sysfs-tagging.rst | 0
Documentation/process/2.Process.rst | 2 +-
Documentation/process/changes.rst | 15 +
Documentation/process/deprecated.rst | 24 +-
Documentation/process/email-clients.rst | 5 +
Documentation/process/programming-language.rst | 9 +-
Documentation/process/submit-checklist.rst | 4 +
Documentation/process/submitting-drivers.rst | 9 +-
Documentation/process/submitting-patches.rst | 280 +-
Documentation/scheduler/sched-capacity.rst | 2 +-
Documentation/scheduler/sched-energy.rst | 2 +-
Documentation/security/credentials.rst | 1 -
Documentation/security/keys/trusted-encrypted.rst | 5 +-
Documentation/sphinx/automarkup.py | 137 +-
Documentation/trace/kprobetrace.rst | 2 +-
Documentation/trace/ring-buffer-design.rst | 26 +-
Documentation/translations/ko_KR/howto.rst | 9 +-
.../translations/ko_KR/memory-barriers.txt | 32 +-
Documentation/translations/zh_CN/arm64/amu.rst | 100 +
Documentation/translations/zh_CN/arm64/index.rst | 16 +
.../translations/zh_CN/filesystems/sysfs.txt | 3 +-
Documentation/translations/zh_CN/index.rst | 1 +
Documentation/virt/index.rst | 2 +-
Documentation/virt/kvm/amd-memory-encryption.rst | 6 +-
Documentation/virt/kvm/api.rst | 4 +-
Documentation/virt/kvm/cpuid.rst | 2 +-
Documentation/virt/uml/user_mode_linux.rst | 4403 --------------------
.../virt/uml/user_mode_linux_howto_v2.rst | 1208 ++++++
Documentation/vm/hmm.rst | 139 +-
Documentation/vm/index.rst | 1 +
Documentation/vm/page_migration.rst | 164 +-
Documentation/watch_queue.rst | 14 +-
MAINTAINERS | 3 +-
include/linux/iio/iio.h | 2 +-
init/Kconfig | 2 +-
mm/Kconfig | 2 +-
mm/nommu.c | 2 +-
samples/kprobes/kprobe_example.c | 2 +-
samples/kprobes/kretprobe_example.c | 2 +-
scripts/coccinelle/api/device_attr_show.cocci | 2 +-
scripts/kernel-doc | 5 +-
85 files changed, 2072 insertions(+), 5256 deletions(-)
create mode 100644 Documentation/ABI/stable/sysfs-kernel-notes
rename Documentation/{filesystems => PCI}/sysfs-pci.rst (100%)
delete mode 100644 Documentation/ia64/xen.rst
create mode 100644 Documentation/maintainer/modifying-patches.rst
rename Documentation/{filesystems => networking}/sysfs-tagging.rst (100%)
create mode 100644 Documentation/translations/zh_CN/arm64/amu.rst
create mode 100644 Documentation/translations/zh_CN/arm64/index.rst
delete mode 100644 Documentation/virt/uml/user_mode_linux.rst
create mode 100644 Documentation/virt/uml/user_mode_linux_howto_v2.rst