Message-ID: <20191201090945.69c6aa4e@lwn.net>
Date:   Sun, 1 Dec 2019 09:09:45 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Linus Torvalds <torvalds@...ux-foundation.org>
Cc:     LKML <linux-kernel@...r.kernel.org>, linux-doc@...r.kernel.org
Subject: [GIT PULL] Documentation for 5.5, take 2

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

Powered by blists - more mailing lists