[GIT PULL] Documentation for 5.5, take 2
From: Jonathan Corbet
Date: Sun Dec 01 2019 - 11:09:52 EST
The following changes since commit
7d194c2100ad2a6dded545887d02754948ca5241:
Linux 5.4-rc4 (2019-10-20 15:56:22 -0400)
are available in the Git repository at:
git://git.lwn.net/linux.git tags/docs-5.5a
for you to fetch changes up to 36bb9778fd11173f2dd1484e4f6797365e18c1d8:
docs: remove a bunch of stray CRs (2019-12-01 08:45:54 -0700)
----------------------------------------------------------------
Here's the main documentation changes for 5.5:
- Various kerneldoc script enhancements.
- More RST conversions; those are slowing down as we run out of things to
convert, but we're a ways from done still.
- Dan's "maintainer profile entry" work landed at last. Now we just need
to get maintainers to fill in the profiles...
- A reworking of the parallel build setup to work better with a variety of
systems (and to not take over huge systems entirely in particular).
- The MAINTAINERS file is now converted to RST during the build.
Hopefully nobody ever tries to print this thing, or they will need to
load a lot of paper.
- A script and documentation making it easy for maintainers to add Link:
tags at commit time.
Rather than revert the patches adding various stray CR characters, I
simply appended one taking them out. There are none left now - I
checked...
As usual, it seems, there are still a couple of annoying conflicts with
mainline. Should it be useful, I've put a proposed resolution at:
git://git.lwn.net/linux.git tags/docs-5.5a-merge
There's nothing all that complex there, though.
----------------------------------------------------------------
Adam Zerella (1):
docs: perf: Add imx-ddr to documentation index
Albert Vaca Cintora (1):
Updated iostats docs
Andre Azevedo (1):
Documentation/scheduler: fix links in sched-stats
Andrà Almeida (2):
kernel-doc: fix processing nested structs with attributes
kernel-doc: add support for ____cacheline_aligned_in_smp attribute
Brendan Jackman (1):
docs: security: fix section hyperlink
Bryan Gurney (1):
dm dust: convert documentation to ReST
Changbin Du (1):
kernel-doc: rename the kernel-doc directive 'functions' to
'identifiers'
Chester Lin (1):
riscv-docs: correct the sequence of the magic number 2 since it's
little endian
Chris Packham (4):
docs: ioctl: fix typo
docs/core-api: memory-allocation: fix typo
docs/core-api: memory-allocation: remove uses of c:func:
docs/core-api: memory-allocation: mention size helpers
Christian Kujau (1):
docs: SafeSetID.rst: Remove spurious '???' characters
Christoph Hellwig (1):
Documentation: document earlycon without options for more platforms
Dan Williams (3):
MAINTAINERS: Reclaim the P: tag for Maintainer Entry Profile
Maintainer Handbook: Maintainer Entry Profile
libnvdimm, MAINTAINERS: Maintainer Entry Profile
Daniel W. S. Almeida (1):
Documentation: security: core.rst: fix warnings
Derek Kiernan (1):
docs: misc: xilinx_sdfec: Actually add documentation
Geert Uytterhoeven (1):
Documentation: debugfs: Document debugfs helper for unsigned long
values
Harald Seiler (1):
docs: driver-api: Remove reference to sgi-ioc4
Jaskaran Singh (3):
docs: filesystems: convert autofs.txt to reST
docs: filesystems: Update code snippets in autofs.rst
docs: filesystems: Add mount map description in Content
Jeff Layton (1):
Documentation: atomic_open called with shared lock on non-O_CREAT
open
Jeremy Cline (1):
docs: kmemleak: DEBUG_KMEMLEAK_EARLY_LOG_SIZE changed names
Jeremy MAURO (2):
scripts/sphinx-pre-install: allow checking for multiple missing files
scripts/sphinx-pre-install: Add a new path for the debian package
"fonts-noto-cjk"
Jon Haslam (1):
docs: fix memory.low description in cgroup-v2.rst
Jonathan Corbet (17):
Merge branch 'dump-struct' into docs-next
docs: No structured comments in kernel/dma/coherent.c
docs: remove :c:func: from refcount-vs-atomic.rst
docs: Catch up with the new location of get_user_pages_fast()
genalloc: Fix a set of docs build warnings
docs/driver-api: Catch up with dma_buf file-name changes
docs: Fix "make help" suggestion for SPHINXDIR
docs: move botching-up-ioctls.rst to the process guide
docs: Move the user-space ioctl() docs to userspace-api
docs: remove :c:func: from genalloc.rst
docs: remove :c:func: from genericirq.rst
Merge tag 'v5.4-rc4' into docs-next
Revert "Documentation: admin-guide: add earlycon documentation for
RISC-V" docs: Add request_irq() documentation
docs: fix up the maintainer profile document
Merge branch 'maintainer-profile' into docs-next
docs: remove a bunch of stray CRs
Jonathan NeuschÃfer (12):
docs: it_IT: maintainer-pgp-guide: Fix reference to "Nitrokey Pro 2"
Documentation: networking: device drivers: Remove stray asterisks
docs: networking: devlink-trap: Fix reference to other document
docs: networking: phy: Improve phrasing
docs: admin-guide: Sort the "unordered guides" to avoid merge
conflicts docs: admin-guide: Move Dell RBU document from driver-api
docs: admin-guide: dell_rbu: Rework the title
docs: admin-guide: dell_rbu: Improve formatting and spelling
docs: driver-api: pti_intel_mid: Enable syntax highlighting for C
code block docs: i2c: Fix SPDX-License-Identifier syntax
docs: w1: Fix SPDX-License-Identifier syntax
scripts/kernel-doc: Add support for named variable macro arguments
Kees Cook (6):
docs: Use make invocation's -j argument for parallelism
doc-rst: Reduce CSS padding around Field
doc-rst: Programmatically render MAINTAINERS into ReST
docs, parallelism: Fix failure path and add comment
docs, parallelism: Do not leak blocking mode to other readers
docs, parallelism: Rearrange how jobserver reservations are made
Konstantin Ryabitsev (1):
docs: process: Add base-commit trailer usage
Leonard Crestez (1):
docs: Add initial documentation for devfreq
Linus Walleij (1):
Documentation: Document how to get links with git am
Louis Taylor (2):
docs: driver-api: make interconnect title quieter
scripts/sphinx-pre-install: fix Arch latexmk dependency
Martin Kepplinger (2):
mailmap: add new email address for Martin Kepplinger
CREDITS: update email address for Martin Kepplinger
Masami Hiramatsu (1):
Documentation: Remove bootmem_debug from kernel-parameters.txt
Masanari Iida (2):
docs: admin-guide: Fix min value of threads-max in kernel.rst
docs: admin-guide: Remove threads-max auto-tuning
Mauro Carvalho Chehab (3):
docs: fix some broken references
bindings: rename links to mason USB2/USB3 DT files
bindings: MAINTAINERS: fix references to Allwinner LRADC
Mike Leach (4):
coresight: etm4x: docs: Update ABI doc for new sysfs name scheme.
coresight: etm4x: docs: Update ABI doc for new sysfs etm4 attributes
coresight: docs: Create common sub-directory for coresight trace.
coresight: etm4x: docs: Adds detailed document for programming etm4x.
Miles Chen (1):
docs: printk-formats: add ptrdiff_t type to printk-formats
Oleksandr Natalenko (1):
docs: admin-guide: fix printk_ratelimit explanation
Paul Walmsley (1):
Documentation: admin-guide: add earlycon documentation for RISC-V
SeongJae Park (7):
docs/memory-barriers.txt/kokr: Rewrite "KERNEL I/O BARRIER EFFECTS"
section Documentation/kokr: Kill all references to mmiowb()
docs/memory-barriers.txt/kokr: Fix style, spacing and grammar in I/O
section docs/memory-barriers.txt/kokr: Update I/O section to be clearer
about CPU vs thread docs/memory-barriers.txt: Remove remaining references
to mmiowb() Documentation/translation: Use Korean for Korean translation
title Documentation/process/howto/kokr: Update for 4.x -> 5.x versioning
Shuah Khan (1):
scripts/sphinx-pre-install: add how to exit virtualenv usage message
Tom Lendacky (1):
Documentation/process: Add AMD contact for embargoed hardware issues
.mailmap | 1 +
CREDITS | 3 +-
.../ABI/testing/sysfs-bus-coresight-devices-etm4x | 183 +++--
Documentation/Makefile | 6 +-
Documentation/admin-guide/LSM/SafeSetID.rst | 4 +-
Documentation/admin-guide/cgroup-v2.rst | 7 +-
.../{driver-api => admin-guide}/dell_rbu.rst | 14 +-
.../device-mapper/{dm-dust.txt => dm-dust.rst} | 243 ++++---
Documentation/admin-guide/device-mapper/index.rst | 1 +
Documentation/admin-guide/index.rst | 65 +-
Documentation/admin-guide/iostats.rst | 47 +-
Documentation/admin-guide/kernel-parameters.txt | 12 +-
Documentation/admin-guide/perf/imx-ddr.rst | 35 +-
Documentation/admin-guide/perf/index.rst | 1 +
Documentation/admin-guide/sysctl/kernel.rst | 12 +-
Documentation/conf.py | 3 +-
Documentation/core-api/genalloc.rst | 26 +-
Documentation/core-api/genericirq.rst | 52 +-
Documentation/core-api/memory-allocation.rst | 50 +-
Documentation/core-api/mm-api.rst | 2 +-
Documentation/core-api/printk-formats.rst | 14 +
Documentation/core-api/refcount-vs-atomic.rst | 36 +-
Documentation/dev-tools/kmemleak.rst | 2 +-
.../devicetree/bindings/cpu/cpu-topology.txt | 2 +-
.../devicetree/bindings/timer/ingenic,tcu.txt | 2 +-
Documentation/doc-guide/kernel-doc.rst | 29 +-
Documentation/driver-api/devfreq.rst | 30 +
Documentation/driver-api/dma-buf.rst | 6 +-
Documentation/driver-api/gpio/driver.rst | 2 +-
Documentation/driver-api/index.rst | 3 +-
Documentation/driver-api/infrastructure.rst | 3 -
Documentation/driver-api/interconnect.rst | 2 +-
Documentation/driver-api/pti_intel_mid.rst | 4 +-
.../filesystems/{autofs.txt => autofs.rst} | 263 +++----
Documentation/filesystems/debugfs.txt | 10 +-
Documentation/filesystems/index.rst | 1 +
Documentation/filesystems/locking.rst | 2 +-
Documentation/hwmon/inspur-ipsps1.rst | 2 +-
Documentation/i2c/busses/index.rst | 2 +-
Documentation/i2c/index.rst | 2 +-
Documentation/index.rst | 1 -
Documentation/maintainer/configure-git.rst | 30 +
Documentation/maintainer/index.rst | 1 +
.../maintainer/maintainer-entry-profile.rst | 102 +++
Documentation/memory-barriers.txt | 11 +-
Documentation/mips/ingenic-tcu.rst | 2 +-
Documentation/misc-devices/xilinx_sdfec.rst | 291 ++++++++
.../networking/device_drivers/intel/e100.rst | 14 +-
.../networking/device_drivers/intel/e1000.rst | 12 +-
.../networking/device_drivers/intel/e1000e.rst | 14 +-
.../networking/device_drivers/intel/fm10k.rst | 10 +-
.../networking/device_drivers/intel/i40e.rst | 8 +-
.../networking/device_drivers/intel/iavf.rst | 8 +-
.../networking/device_drivers/intel/ice.rst | 6 +-
.../networking/device_drivers/intel/igb.rst | 12 +-
.../networking/device_drivers/intel/igbvf.rst | 6 +-
.../networking/device_drivers/intel/ixgbe.rst | 10 +-
.../networking/device_drivers/intel/ixgbevf.rst | 6 +-
.../networking/device_drivers/mellanox/mlx5.rst | 2 +-
.../networking/device_drivers/pensando/ionic.rst | 6 +-
Documentation/networking/devlink-trap.rst | 2 +-
Documentation/networking/phy.rst | 2 +-
Documentation/nvdimm/maintainer-entry-profile.rst | 59 ++
.../{ioctl => process}/botching-up-ioctls.rst | 2 +-
.../process/embargoed-hardware-issues.rst | 2 +-
Documentation/process/index.rst | 2 +
Documentation/process/maintainers.rst | 1 +
Documentation/process/submitting-patches.rst | 53 +-
Documentation/riscv/boot-image-header.rst | 2 +-
Documentation/scheduler/sched-stats.rst | 4 +-
Documentation/security/keys/core.rst | 2 +-
Documentation/security/lsm.rst | 2 +-
Documentation/sphinx-static/theme_overrides.css | 10 +
Documentation/sphinx/kerneldoc.py | 17 +-
Documentation/sphinx/maintainers_include.py | 197 +++++
Documentation/sphinx/parallel-wrapper.sh | 33 +
.../trace/{ => coresight}/coresight-cpu-debug.rst | 0
.../trace/coresight/coresight-etm4x-reference.rst | 798
+++++++++++++++++++++ Documentation/trace/{ => coresight}/coresight.rst
| 2 +- Documentation/trace/coresight/index.rst | 9 +
Documentation/trace/index.rst | 3 +-
.../it_IT/process/maintainer-pgp-guide.rst | 2 +-
Documentation/translations/ko_KR/howto.rst | 56 +-
Documentation/translations/ko_KR/index.rst | 4 +-
.../translations/ko_KR/memory-barriers.txt | 227 +++---
Documentation/userspace-api/index.rst | 1 +
Documentation/{ => userspace-api}/ioctl/cdrom.rst | 0
Documentation/{ => userspace-api}/ioctl/hdio.rst | 0
Documentation/{ => userspace-api}/ioctl/index.rst | 1 -
.../{ => userspace-api}/ioctl/ioctl-decoding.rst | 0
.../{ => userspace-api}/ioctl/ioctl-number.rst | 0
Documentation/w1/index.rst | 2 +-
MAINTAINERS | 88 +--
drivers/net/ethernet/faraday/ftgmac100.c | 2 +-
drivers/net/ethernet/pensando/ionic/ionic_if.h | 4 +-
drivers/platform/x86/Kconfig | 2 +-
drivers/platform/x86/dell_rbu.c | 2 +-
fs/cifs/cifsfs.c | 2 +-
include/linux/interrupt.h | 13 +
lib/genalloc.c | 2 +-
scripts/jobserver-exec | 66 ++
scripts/kernel-doc | 27 +-
scripts/sphinx-pre-install | 30 +-
103 files changed, 2627 insertions(+), 842 deletions(-)
rename Documentation/{driver-api => admin-guide}/dell_rbu.rst (94%)
rename Documentation/admin-guide/device-mapper/{dm-dust.txt =>
dm-dust.rst} (51%) create mode 100644 Documentation/driver-api/devfreq.rst
rename Documentation/filesystems/{autofs.txt => autofs.rst} (77%)
create mode 100644 Documentation/maintainer/maintainer-entry-profile.rst
create mode 100644 Documentation/misc-devices/xilinx_sdfec.rst
create mode 100644 Documentation/nvdimm/maintainer-entry-profile.rst
rename Documentation/{ioctl => process}/botching-up-ioctls.rst (99%)
create mode 100644 Documentation/process/maintainers.rst
create mode 100755 Documentation/sphinx/maintainers_include.py
create mode 100644 Documentation/sphinx/parallel-wrapper.sh
rename Documentation/trace/{ => coresight}/coresight-cpu-debug.rst (100%)
create mode 100644
Documentation/trace/coresight/coresight-etm4x-reference.rst rename
Documentation/trace/{ => coresight}/coresight.rst (99%) create mode
100644 Documentation/trace/coresight/index.rst rename Documentation/{ =>
userspace-api}/ioctl/cdrom.rst (100%) rename Documentation/{ =>
userspace-api}/ioctl/hdio.rst (100%) rename Documentation/{ =>
userspace-api}/ioctl/index.rst (86%) rename Documentation/{ =>
userspace-api}/ioctl/ioctl-decoding.rst (100%) rename Documentation/{ =>
userspace-api}/ioctl/ioctl-number.rst (100%) create mode 100755
scripts/jobserver-exec