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.5
for you to fetch changes up to 22abcd7569618271cc3609da24bbc0e7541248a4:
Merge branch 'maintainer-profile' into docs-next (2019-11-25 08:43:28 -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.
----------------------------------------------------------------
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 (16):
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
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
On Tue, Nov 26, 2019 at 8:30 AM Jonathan Corbet <[email protected]> wrote:
>
> git://git.lwn.net/linux.git tags/docs-5.5
You are doing something seriously wrong.
There are DOS line-endings now in some of the patches, and I noticed
because I got a conflict in
Documentation/networking/device_drivers/intel/e100.rst
where your version was identical to one I had merged elsewhere, but
had ^M at the end of the new lines.
There are other examples of the same in other places.
I'm not going to pull this. I have no idea what you're doing and how
many incorrect line endings you have that just didn't happen to
conflict.
You have some *serious* tooling issues. We don't do CRLF line endings.
You can do
git grep "^M"
(where that ^M is obviously the CR character, not the two characters
'^' and 'M" to see it. In a good tree, you'll see
[torvalds@i7 linux]$ git grep "^M"
Binary file Documentation/logo.gif matches
but in your tree, you get an additional 59 lines of that bogus CRLF
garbage in these files:
Documentation/admin-guide/dell_rbu.rst
Documentation/networking/device_drivers/intel/e100.rst
Documentation/networking/device_drivers/intel/e1000.rst
Documentation/networking/device_drivers/intel/e1000e.rst
Documentation/networking/device_drivers/intel/fm10k.rst
Documentation/networking/device_drivers/intel/i40e.rst
Documentation/networking/device_drivers/intel/iavf.rst
Documentation/networking/device_drivers/intel/ice.rst
Documentation/networking/device_drivers/intel/igb.rst
Documentation/networking/device_drivers/intel/igbvf.rst
Documentation/networking/device_drivers/intel/ixgbe.rst
Documentation/networking/device_drivers/intel/ixgbevf.rst
Documentation/networking/device_drivers/pensando/ionic.rst
and I have no idea what you've done to make it do that, but I
definitely don't want the end result in my tree.
Linus
On Sat, 30 Nov 2019 15:11:05 -0800
Linus Torvalds <[email protected]> wrote:
> There are DOS line-endings now in some of the patches, and I noticed
> because I got a conflict in
>
> Documentation/networking/device_drivers/intel/e100.rst
>
> where your version was identical to one I had merged elsewhere, but
> had ^M at the end of the new lines.
>
> There are other examples of the same in other places.
>
> I'm not going to pull this. I have no idea what you're doing and how
> many incorrect line endings you have that just didn't happen to
> conflict.
>
> You have some *serious* tooling issues. We don't do CRLF line endings.
Hmm.
So my tooling is "git am", nothing special.
All of the afflicted files arrived in that state as the result of a pair
of patches from Jonathan (copied); I have verified that the original
patches also had the DOS line endings.
The problem repeats if I apply those patches now, even if I add an
explicit "--no-keep-cr" to the "git am" command line. It seems like maybe
my version of git is somehow broken? I have git-2.21.0-1.fc30.x86_64,
FWIW.
Anyway, if I revert the two offending patches and resend the pull, is that
good enough, or do you want this mess out of the history entirely?
Sorry for the trouble,
jon
[ Background for Junio and the git mailing list - Jon's pull request
to me had a lot of whitespace damage from CRLF line endings for some
of the patches he applied. ]
On Sat, Nov 30, 2019 at 4:14 PM Jonathan Corbet <[email protected]> wrote:
>
> So my tooling is "git am", nothing special.
>
> All of the afflicted files arrived in that state as the result of a pair
> of patches from Jonathan (copied); I have verified that the original
> patches also had the DOS line endings.
>
> The problem repeats if I apply those patches now, even if I add an
> explicit "--no-keep-cr" to the "git am" command line. It seems like maybe
> my version of git is somehow broken? I have git-2.21.0-1.fc30.x86_64,
> FWIW.
Hmm. I wonder if the CRLF removal is broken in general, or if the
emails are somehow unusual (patches in attachments or MIME-encoded or
something)? Maybe the CRLF was removed from the envelope email lines,
but if the patch is then decoded from an attachment or something it's
not removed again from there?
Can you attach (not forward) one of the (raw) emails that shows the
problem and keep the git mailing list cc'd?
Linus
On Sat, Nov 30, 2019 at 05:14:28PM -0700, Jonathan Corbet wrote:
[...]
> All of the afflicted files arrived in that state as the result of a pair
> of patches from Jonathan (copied); I have verified that the original
> patches also had the DOS line endings.
Not sure why, or where in the mails' path this happened, but the base64
with CR/LF inside is also present in the copies that went directly to
me, rather than via the mailing lists.
> Anyway, if I revert the two offending patches and resend the pull, is that
> good enough, or do you want this mess out of the history entirely?
On a somewhat related note: "Documentation: networking: device drivers:
Remove stray asterisks" was also picked up via the networking tree.
Perhaps I should have mentioned that when I became aware(?)
> Sorry for the trouble,
Well, same here :/
Jonathan Neuschäfer
On Mon, 2 Dec 2019 01:19:28 +0100
Jonathan Neuschäfer <[email protected]> wrote:
> On a somewhat related note: "Documentation: networking: device drivers:
> Remove stray asterisks" was also picked up via the networking tree.
> Perhaps I should have mentioned that when I became aware(?)
Yeah, I'm not quite sure why that happened. Dave M. suggested I take it
and sent an ack, then it looks like Jeff Kirsher grabbed it as well
anyway for some reason...? Oh well, the resulting conflict brought the
problem to light, at least :)
Thanks,
jon
The pull request you sent on Tue, 26 Nov 2019 09:30:02 -0700:
> git://git.lwn.net/linux.git tags/docs-5.5
has been merged into torvalds/linux.git:
https://git.kernel.org/torvalds/c/36bb9778fd11173f2dd1484e4f6797365e18c1d8
Thank you!
--
Deet-doot-dot, I am a bot.
https://korg.wiki.kernel.org/userdoc/prtracker