This series actually folds the previous Sphinx 3.x patch series
with the other patches I sent fixing warnings with Sphinx
2.x and with kernel-doc and that weren't merged yet via
some other tree.
It is based on the top of upstream, plus the media
pull request I sent yesterday:
https://lore.kernel.org/lkml/[email protected]/
My plan is to send a pull request with those patches after Thursday's
linux next release.
On this series, I removed the patches that depend on material
currently found only at linux-next.
Mauro Carvalho Chehab (79):
scripts: kernel-doc: add support for typedef enum
scripts: kernel-doc: make it more compatible with Sphinx 3.x
scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx
3.x
scripts: kernel-doc: fix troubles with line counts
scripts: kernel-doc: reimplement -nofunction argument
scripts: kernel-doc: fix typedef identification
scripts: kernel-doc: don't mangle with parameter list
scripts: kernel-doc: allow passing desired Sphinx C domain dialect
scripts: kernel-doc: fix line number handling
scripts: kernel-doc: try to use c:function if possible
docs: cdomain.py: add support for a new Sphinx 3.1+ tag
docs: cdomain.py: extend it to handle new Sphinx 3.x tags
docs: kerneldoc.py: append the name of the parsed doc file
docs: kerneldoc.py: add support for kerneldoc -nosymbol
media: docs: make CEC documents compatible with Sphinx 3.1+
media: docs: make V4L documents more compatible with Sphinx 3.1+
media: docs: make DVB documents more compatible with Sphinx 3.1+
media: docs: make MC documents more compatible with Sphinx 3.1+
media: docs: make RC documents more compatible with Sphinx 3.1+
media: cec-core.rst: don't use c:type for structs
docs: remove some replace macros like |struct foo|
docs: get rid of :c:type explicit declarations for structs
docs: trace-uses.rst: remove bogus c-domain tags
docs: it_IT: fix namespace collisions at locking.rst
docs: net: ieee802154.rst: fix C expressions
docs: genericirq.rst: don't document chip.c functions twice
docs: kernel-api.rst: drop kernel/irq/manage.c kernel-doc tag
docs: remove sound API duplication
docs: basics.rst: move kernel-doc workqueue markups to workqueue.rst
docs: scsi: target.rst: remove iSCSI transport class kernel-doc markup
docs: device_link.rst: remove duplicated kernel-doc include
docs: basics.rst: get rid of rcu kernel-doc macros
docs: pstore-blk.rst: fix kernel-doc tags
docs: fs: fscrypt.rst: get rid of :c:type: tags
docs: devices.rst: get rid of :c:type macros
docs: sound: writing-an-alsa-driver.rst: get rid of :c:type
docs: block: blk-mq.rst: get rid of :c:type
docs: writing-an-alsa-driver.rst: fix some bad c:func: markups
docs: fpga: replace :c:member: macros
docs: kgdb.rst: fix :c:type: usages
docs: libata.rst: fix a wrong usage of :c:type: tag
docs: infrastructure.rst: don't include firmware kernel-doc
docs: gpu: i915.rst: Fix several C duplication warnings
docs: devices.rst: fix a C reference markup
docs: it_IT: hacking.rst: fix a typo on a markup
docs: mei.rst: fix a C expression markup
docs: basics.rst: avoid duplicated C function declaration
docs: conf.py: fix c:function support with Sphinx 3.x
docs: conf.py: change the Sphinx 3.x+ text
docs: infrastructure.rst: exclude device_link_state from device.h
docs: zh_CN: amu.rst: fix document title markup
media: uAPI: buffer.rst: remove a left-over documentation
math64.h: kernel-docs: Convert some markups into normal comments
memblock: get rid of a :c:type leftover
dt-bindings: fix references to files converted to yaml
net: appletalk: Kconfig: Fix docs location
drivers: net: hamradio: fix document location
docs: powerpc: syscall64-abi.rst: fix a malformed table
block: bio: fix a warning at the kernel-doc markups
kunit: test.h: solve kernel-doc warnings
docs: bio: fix a kerneldoc markup
drivers: core: fix kernel-doc markup for dev_err_probe()
kunit: test.h: fix a bad kernel-doc markup
docs: amdgpu: fix a warning when building the documentation
locking/refcount: document the new "oldp" pointer value
usb: docs: document altmode register/unregister functions
nl80211: docs: add a description for s1g_cap parameter
IB/srpt: docs: add a description for cq_size member
rcu/tree: docs: document bkvcache new members at struct kfree_rcu_cpu
Input: sparse-keymap: add a description for @sw
drm/amd/display: kernel-doc: document force_timing_sync
drm: kernel-doc: drm_dp_helper.h: fix a typo
gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markups
drm: kernel-doc: add description for a new function parameter
docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup
workqueue: fix a kernel-doc warning
mm/doc: fix a literal block markup
drm: drm_edid: remove a duplicated kernel-doc declaration
PM / devfreq: remove a duplicated kernel-doc markup
Nícolas F. R. A. Prado (1):
docs: automarkup.py: make it ready for Sphinx 3.1+
Documentation/admin-guide/pm/cpufreq.rst | 11 +-
Documentation/admin-guide/pstore-blk.rst | 10 +-
Documentation/block/blk-mq.rst | 12 +-
Documentation/block/inline-encryption.rst | 8 +-
Documentation/conf.py | 65 +++-
Documentation/core-api/genericirq.rst | 2 +
Documentation/core-api/kernel-api.rst | 6 -
Documentation/core-api/workqueue.rst | 2 +
Documentation/dev-tools/kgdb.rst | 6 +-
.../bindings/display/tilcdc/tilcdc.txt | 2 +-
.../bindings/mailbox/omap-mailbox.txt | 2 +-
.../devicetree/bindings/media/i2c/tvp5150.txt | 2 +-
.../bindings/pwm/google,cros-ec-pwm.yaml | 2 +-
.../bindings/soc/qcom/qcom,smd-rpm.yaml | 2 +-
.../bindings/sound/google,cros-ec-codec.yaml | 2 +-
Documentation/doc-guide/kernel-doc.rst | 8 +
Documentation/driver-api/basics.rst | 19 +-
Documentation/driver-api/device_link.rst | 13 +-
Documentation/driver-api/fpga/fpga-bridge.rst | 4 +-
Documentation/driver-api/fpga/fpga-mgr.rst | 6 +-
.../driver-api/fpga/fpga-programming.rst | 2 +-
Documentation/driver-api/fpga/fpga-region.rst | 6 +-
Documentation/driver-api/iio/buffers.rst | 2 +-
Documentation/driver-api/iio/core.rst | 6 +-
Documentation/driver-api/iio/hw-consumer.rst | 2 +-
.../driver-api/iio/triggered-buffers.rst | 2 +-
Documentation/driver-api/iio/triggers.rst | 4 +-
Documentation/driver-api/index.rst | 1 -
Documentation/driver-api/infrastructure.rst | 4 +-
Documentation/driver-api/libata.rst | 2 +-
Documentation/driver-api/media/cec-core.rst | 2 +-
.../driver-api/media/dtv-frontend.rst | 4 +-
Documentation/driver-api/media/mc-core.rst | 24 +-
.../driver-api/media/v4l2-controls.rst | 2 +-
Documentation/driver-api/media/v4l2-dev.rst | 8 +-
.../driver-api/media/v4l2-device.rst | 6 +-
Documentation/driver-api/media/v4l2-event.rst | 10 +-
Documentation/driver-api/media/v4l2-fh.rst | 16 +-
.../driver-api/media/v4l2-subdev.rst | 2 +-
Documentation/driver-api/mei/mei.rst | 2 +-
Documentation/driver-api/pm/cpuidle.rst | 65 ++--
Documentation/driver-api/pm/devices.rst | 26 +-
Documentation/driver-api/regulator.rst | 4 +-
Documentation/driver-api/sound.rst | 54 ----
Documentation/driver-api/target.rst | 12 -
Documentation/driver-api/usb/URB.rst | 2 +-
Documentation/driver-api/usb/gadget.rst | 10 +-
Documentation/driver-api/usb/hotplug.rst | 2 +-
Documentation/driver-api/usb/typec_bus.rst | 8 +-
Documentation/filesystems/fscrypt.rst | 61 ++--
Documentation/filesystems/fsverity.rst | 2 +-
Documentation/gpu/amdgpu.rst | 11 +-
Documentation/gpu/i915.rst | 29 +-
Documentation/networking/ieee802154.rst | 18 +-
Documentation/powerpc/syscall64-abi.rst | 32 +-
Documentation/sound/designs/tracepoints.rst | 22 +-
.../sound/kernel-api/alsa-driver-api.rst | 1 +
.../kernel-api/writing-an-alsa-driver.rst | 110 +++----
Documentation/sphinx/automarkup.py | 69 +++-
Documentation/sphinx/cdomain.py | 93 +++++-
Documentation/sphinx/kerneldoc.py | 15 +-
Documentation/sphinx/parse-headers.pl | 2 +-
Documentation/trace/ftrace-uses.rst | 12 +-
.../it_IT/kernel-hacking/hacking.rst | 2 +-
.../it_IT/kernel-hacking/locking.rst | 2 +
.../translations/zh_CN/arm64/amu.rst | 4 +-
.../media/cec/cec-func-close.rst | 10 +-
.../media/cec/cec-func-ioctl.rst | 11 +-
.../userspace-api/media/cec/cec-func-open.rst | 10 +-
.../userspace-api/media/cec/cec-func-poll.rst | 14 +-
.../media/cec/cec-ioc-adap-g-caps.rst | 10 +-
.../media/cec/cec-ioc-adap-g-conn-info.rst | 11 +-
.../media/cec/cec-ioc-adap-g-log-addrs.rst | 20 +-
.../media/cec/cec-ioc-adap-g-phys-addr.rst | 15 +-
.../media/cec/cec-ioc-dqevent.rst | 15 +-
.../media/cec/cec-ioc-g-mode.rst | 16 +-
.../media/cec/cec-ioc-receive.rst | 18 +-
.../dvb/audio-bilingual-channel-select.rst | 7 +-
.../media/dvb/audio-channel-select.rst | 8 +-
.../media/dvb/audio-clear-buffer.rst | 8 +-
.../media/dvb/audio-continue.rst | 7 +-
.../userspace-api/media/dvb/audio-fclose.rst | 7 +-
.../userspace-api/media/dvb/audio-fopen.rst | 7 +-
.../userspace-api/media/dvb/audio-fwrite.rst | 7 +-
.../media/dvb/audio-get-capabilities.rst | 8 +-
.../media/dvb/audio-get-status.rst | 8 +-
.../userspace-api/media/dvb/audio-pause.rst | 9 +-
.../userspace-api/media/dvb/audio-play.rst | 7 +-
.../media/dvb/audio-select-source.rst | 8 +-
.../media/dvb/audio-set-av-sync.rst | 8 +-
.../media/dvb/audio-set-bypass-mode.rst | 9 +-
.../userspace-api/media/dvb/audio-set-id.rst | 9 +-
.../media/dvb/audio-set-mixer.rst | 9 +-
.../media/dvb/audio-set-mute.rst | 8 +-
.../media/dvb/audio-set-streamtype.rst | 10 +-
.../userspace-api/media/dvb/audio-stop.rst | 9 +-
.../userspace-api/media/dvb/ca-fclose.rst | 7 +-
.../userspace-api/media/dvb/ca-fopen.rst | 7 +-
.../userspace-api/media/dvb/ca-get-cap.rst | 8 +-
.../media/dvb/ca-get-descr-info.rst | 9 +-
.../userspace-api/media/dvb/ca-get-msg.rst | 10 +-
.../media/dvb/ca-get-slot-info.rst | 9 +-
.../userspace-api/media/dvb/ca-reset.rst | 9 +-
.../userspace-api/media/dvb/ca-send-msg.rst | 9 +-
.../userspace-api/media/dvb/ca-set-descr.rst | 8 +-
.../userspace-api/media/dvb/dmx-add-pid.rst | 10 +-
.../userspace-api/media/dvb/dmx-expbuf.rst | 11 +-
.../userspace-api/media/dvb/dmx-fclose.rst | 9 +-
.../userspace-api/media/dvb/dmx-fopen.rst | 5 +-
.../userspace-api/media/dvb/dmx-fread.rst | 7 +-
.../userspace-api/media/dvb/dmx-fwrite.rst | 6 +-
.../media/dvb/dmx-get-pes-pids.rst | 12 +-
.../userspace-api/media/dvb/dmx-get-stc.rst | 12 +-
.../userspace-api/media/dvb/dmx-mmap.rst | 15 +-
.../userspace-api/media/dvb/dmx-munmap.rst | 14 +-
.../userspace-api/media/dvb/dmx-qbuf.rst | 17 +-
.../userspace-api/media/dvb/dmx-querybuf.rst | 9 +-
.../media/dvb/dmx-remove-pid.rst | 10 +-
.../userspace-api/media/dvb/dmx-reqbufs.rst | 9 +-
.../media/dvb/dmx-set-buffer-size.rst | 10 +-
.../media/dvb/dmx-set-filter.rst | 12 +-
.../media/dvb/dmx-set-pes-filter.rst | 13 +-
.../userspace-api/media/dvb/dmx-start.rst | 11 +-
.../userspace-api/media/dvb/dmx-stop.rst | 9 +-
.../media/dvb/fe-diseqc-recv-slave-reply.rst | 9 +-
.../media/dvb/fe-diseqc-reset-overload.rst | 9 +-
.../media/dvb/fe-diseqc-send-burst.rst | 10 +-
.../media/dvb/fe-diseqc-send-master-cmd.rst | 9 +-
.../dvb/fe-dishnetwork-send-legacy-cmd.rst | 10 +-
.../media/dvb/fe-enable-high-lnb-voltage.rst | 10 +-
.../userspace-api/media/dvb/fe-get-event.rst | 12 +-
.../media/dvb/fe-get-frontend.rst | 12 +-
.../userspace-api/media/dvb/fe-get-info.rst | 11 +-
.../media/dvb/fe-get-property.rst | 15 +-
.../userspace-api/media/dvb/fe-read-ber.rst | 9 +-
.../media/dvb/fe-read-signal-strength.rst | 9 +-
.../userspace-api/media/dvb/fe-read-snr.rst | 9 +-
.../media/dvb/fe-read-status.rst | 11 +-
.../media/dvb/fe-read-uncorrected-blocks.rst | 9 +-
.../media/dvb/fe-set-frontend-tune-mode.rst | 10 +-
.../media/dvb/fe-set-frontend.rst | 11 +-
.../userspace-api/media/dvb/fe-set-tone.rst | 10 +-
.../media/dvb/fe-set-voltage.rst | 10 +-
.../media/dvb/frontend_f_close.rst | 8 +-
.../media/dvb/frontend_f_open.rst | 10 +-
.../userspace-api/media/dvb/net-add-if.rst | 9 +-
.../userspace-api/media/dvb/net-get-if.rst | 10 +-
.../userspace-api/media/dvb/net-remove-if.rst | 10 +-
.../media/dvb/video-clear-buffer.rst | 8 +-
.../userspace-api/media/dvb/video-command.rst | 10 +-
.../media/dvb/video-continue.rst | 8 +-
.../media/dvb/video-fast-forward.rst | 10 +-
.../userspace-api/media/dvb/video-fclose.rst | 6 +-
.../userspace-api/media/dvb/video-fopen.rst | 6 +-
.../userspace-api/media/dvb/video-freeze.rst | 8 +-
.../userspace-api/media/dvb/video-fwrite.rst | 6 +-
.../media/dvb/video-get-capabilities.rst | 8 +-
.../media/dvb/video-get-event.rst | 8 +-
.../media/dvb/video-get-frame-count.rst | 8 +-
.../userspace-api/media/dvb/video-get-pts.rst | 8 +-
.../media/dvb/video-get-size.rst | 8 +-
.../media/dvb/video-get-status.rst | 7 +-
.../userspace-api/media/dvb/video-play.rst | 8 +-
.../media/dvb/video-select-source.rst | 7 +-
.../media/dvb/video-set-blank.rst | 8 +-
.../media/dvb/video-set-display-format.rst | 8 +-
.../media/dvb/video-set-format.rst | 9 +-
.../media/dvb/video-set-streamtype.rst | 8 +-
.../media/dvb/video-slowmotion.rst | 10 +-
.../media/dvb/video-stillpicture.rst | 8 +-
.../userspace-api/media/dvb/video-stop.rst | 8 +-
.../media/dvb/video-try-command.rst | 8 +-
.../media/mediactl/media-func-close.rst | 10 +-
.../media/mediactl/media-func-ioctl.rst | 10 +-
.../media/mediactl/media-func-open.rst | 10 +-
.../media/mediactl/media-ioc-device-info.rst | 13 +-
.../mediactl/media-ioc-enum-entities.rst | 11 +-
.../media/mediactl/media-ioc-enum-links.rst | 13 +-
.../media/mediactl/media-ioc-g-topology.rst | 14 +-
.../mediactl/media-ioc-request-alloc.rst | 11 +-
.../media/mediactl/media-ioc-setup-link.rst | 10 +-
.../mediactl/media-request-ioc-queue.rst | 7 +-
.../mediactl/media-request-ioc-reinit.rst | 8 +-
.../media/mediactl/request-api.rst | 5 +-
.../media/mediactl/request-func-close.rst | 8 +-
.../media/mediactl/request-func-ioctl.rst | 8 +-
.../media/mediactl/request-func-poll.rst | 12 +-
.../media/rc/lirc-get-features.rst | 9 +-
.../media/rc/lirc-get-rec-mode.rst | 12 +-
.../media/rc/lirc-get-rec-resolution.rst | 8 +-
.../media/rc/lirc-get-send-mode.rst | 14 +-
.../media/rc/lirc-get-timeout.rst | 13 +-
.../userspace-api/media/rc/lirc-read.rst | 10 +-
.../rc/lirc-set-measure-carrier-mode.rst | 8 +-
.../media/rc/lirc-set-rec-carrier-range.rst | 6 +-
.../media/rc/lirc-set-rec-carrier.rst | 8 +-
.../media/rc/lirc-set-rec-timeout-reports.rst | 8 +-
.../media/rc/lirc-set-rec-timeout.rst | 13 +-
.../media/rc/lirc-set-send-carrier.rst | 8 +-
.../media/rc/lirc-set-send-duty-cycle.rst | 8 +-
.../media/rc/lirc-set-transmitter-mask.rst | 8 +-
.../media/rc/lirc-set-wideband-receiver.rst | 8 +-
.../userspace-api/media/rc/lirc-write.rst | 7 +-
.../userspace-api/media/v4l/buffer.rst | 28 +-
.../userspace-api/media/v4l/dev-capture.rst | 7 +-
.../userspace-api/media/v4l/dev-output.rst | 7 +-
.../userspace-api/media/v4l/dev-raw-vbi.rst | 19 +-
.../userspace-api/media/v4l/dev-rds.rst | 12 +-
.../media/v4l/dev-sliced-vbi.rst | 31 +-
.../userspace-api/media/v4l/diff-v4l.rst | 39 +--
.../userspace-api/media/v4l/dmabuf.rst | 8 +-
.../userspace-api/media/v4l/format.rst | 7 +-
.../userspace-api/media/v4l/func-close.rst | 8 +-
.../userspace-api/media/v4l/func-ioctl.rst | 10 +-
.../userspace-api/media/v4l/func-mmap.rst | 18 +-
.../userspace-api/media/v4l/func-munmap.rst | 14 +-
.../userspace-api/media/v4l/func-open.rst | 14 +-
.../userspace-api/media/v4l/func-poll.rst | 40 ++-
.../userspace-api/media/v4l/func-read.rst | 39 ++-
.../userspace-api/media/v4l/func-select.rst | 42 ++-
.../userspace-api/media/v4l/func-write.rst | 13 +-
.../userspace-api/media/v4l/hist-v4l2.rst | 70 +---
Documentation/userspace-api/media/v4l/io.rst | 6 +-
.../media/v4l/libv4l-introduction.rst | 30 +-
.../userspace-api/media/v4l/mmap.rst | 26 +-
.../userspace-api/media/v4l/open.rst | 15 +-
Documentation/userspace-api/media/v4l/rw.rst | 18 +-
.../userspace-api/media/v4l/streaming-par.rst | 5 +-
.../userspace-api/media/v4l/userp.rst | 11 +-
.../media/v4l/vidioc-create-bufs.rst | 11 +-
.../media/v4l/vidioc-cropcap.rst | 11 +-
.../media/v4l/vidioc-dbg-g-chip-info.rst | 13 +-
.../media/v4l/vidioc-dbg-g-register.rst | 18 +-
.../media/v4l/vidioc-decoder-cmd.rst | 19 +-
.../media/v4l/vidioc-dqevent.rst | 19 +-
.../media/v4l/vidioc-dv-timings-cap.rst | 17 +-
.../media/v4l/vidioc-encoder-cmd.rst | 25 +-
.../media/v4l/vidioc-enum-dv-timings.rst | 16 +-
.../media/v4l/vidioc-enum-fmt.rst | 12 +-
.../media/v4l/vidioc-enum-frameintervals.rst | 15 +-
.../media/v4l/vidioc-enum-framesizes.rst | 16 +-
.../media/v4l/vidioc-enum-freq-bands.rst | 12 +-
.../media/v4l/vidioc-enumaudio.rst | 10 +-
.../media/v4l/vidioc-enumaudioout.rst | 10 +-
.../media/v4l/vidioc-enuminput.rst | 14 +-
.../media/v4l/vidioc-enumoutput.rst | 13 +-
.../media/v4l/vidioc-enumstd.rst | 23 +-
.../userspace-api/media/v4l/vidioc-expbuf.rst | 14 +-
.../media/v4l/vidioc-g-audio.rst | 18 +-
.../media/v4l/vidioc-g-audioout.rst | 16 +-
.../userspace-api/media/v4l/vidioc-g-crop.rst | 16 +-
.../userspace-api/media/v4l/vidioc-g-ctrl.rst | 16 +-
.../media/v4l/vidioc-g-dv-timings.rst | 26 +-
.../userspace-api/media/v4l/vidioc-g-edid.rst | 25 +-
.../media/v4l/vidioc-g-enc-index.rst | 13 +-
.../media/v4l/vidioc-g-ext-ctrls.rst | 21 +-
.../userspace-api/media/v4l/vidioc-g-fbuf.rst | 18 +-
.../userspace-api/media/v4l/vidioc-g-fmt.rst | 22 +-
.../media/v4l/vidioc-g-frequency.rst | 16 +-
.../media/v4l/vidioc-g-input.rst | 15 +-
.../media/v4l/vidioc-g-jpegcomp.rst | 17 +-
.../media/v4l/vidioc-g-modulator.rst | 17 +-
.../media/v4l/vidioc-g-output.rst | 15 +-
.../userspace-api/media/v4l/vidioc-g-parm.rst | 30 +-
.../media/v4l/vidioc-g-priority.rst | 16 +-
.../media/v4l/vidioc-g-selection.rst | 15 +-
.../media/v4l/vidioc-g-sliced-vbi-cap.rst | 12 +-
.../userspace-api/media/v4l/vidioc-g-std.rst | 24 +-
.../media/v4l/vidioc-g-tuner.rst | 19 +-
.../media/v4l/vidioc-log-status.rst | 10 +-
.../media/v4l/vidioc-overlay.rst | 10 +-
.../media/v4l/vidioc-prepare-buf.rst | 10 +-
.../userspace-api/media/v4l/vidioc-qbuf.rst | 17 +-
.../media/v4l/vidioc-query-dv-timings.rst | 15 +-
.../media/v4l/vidioc-querybuf.rst | 10 +-
.../media/v4l/vidioc-querycap.rst | 16 +-
.../media/v4l/vidioc-queryctrl.rst | 22 +-
.../media/v4l/vidioc-querystd.rst | 15 +-
.../media/v4l/vidioc-reqbufs.rst | 10 +-
.../media/v4l/vidioc-s-hw-freq-seek.rst | 11 +-
.../media/v4l/vidioc-streamon.rst | 14 +-
.../v4l/vidioc-subdev-enum-frame-interval.rst | 10 +-
.../v4l/vidioc-subdev-enum-frame-size.rst | 11 +-
.../v4l/vidioc-subdev-enum-mbus-code.rst | 10 +-
.../media/v4l/vidioc-subdev-g-crop.rst | 16 +-
.../media/v4l/vidioc-subdev-g-fmt.rst | 17 +-
.../v4l/vidioc-subdev-g-frame-interval.rst | 16 +-
.../media/v4l/vidioc-subdev-g-selection.rst | 17 +-
.../media/v4l/vidioc-subdev-querycap.rst | 9 +-
.../media/v4l/vidioc-subscribe-event.rst | 17 +-
.../virt/uml/user_mode_linux_howto_v2.rst | 1 +
Documentation/vm/hmm.rst | 2 +-
Documentation/vm/ksm.rst | 2 +-
Documentation/vm/memory-model.rst | 6 +-
MAINTAINERS | 16 +-
block/bio.c | 4 +-
drivers/base/core.c | 7 +-
.../gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h | 2 +
drivers/gpu/drm/drm_prime.c | 1 +
drivers/infiniband/ulp/srpt/ib_srpt.h | 1 +
drivers/net/appletalk/Kconfig | 2 +-
drivers/net/hamradio/scc.c | 2 +-
include/drm/drm_dp_helper.h | 2 +-
include/drm/drm_edid.h | 7 -
include/kunit/test.h | 16 +-
include/linux/devfreq.h | 7 +-
include/linux/input/sparse-keymap.h | 1 +
include/linux/math64.h | 8 +-
include/linux/refcount.h | 7 +
include/linux/usb/typec_altmode.h | 16 +
include/net/cfg80211.h | 1 +
kernel/rcu/tree.c | 14 +-
kernel/workqueue.c | 3 +
mm/ksm.c | 2 +-
mm/memblock.c | 8 +-
scripts/kernel-doc | 303 +++++++++++++-----
316 files changed, 1921 insertions(+), 2285 deletions(-)
delete mode 100644 Documentation/driver-api/sound.rst
--
2.26.2
Changeset 53c72b590b3a ("rcu/tree: cache specified number of objects")
added new members for struct kfree_rcu_cpu, but didn't add the
corresponding at the kernel-doc markup, as repoted when doing
"make htmldocs":
./kernel/rcu/tree.c:3113: warning: Function parameter or member 'bkvcache' not described in 'kfree_rcu_cpu'
./kernel/rcu/tree.c:3113: warning: Function parameter or member 'nr_bkv_objs' not described in 'kfree_rcu_cpu'
So, move the description for bkvcache to kernel-doc, and add a
description for nr_bkv_objs.
Fixes: 53c72b590b3a ("rcu/tree: cache specified number of objects")
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
kernel/rcu/tree.c | 14 ++++++--------
1 file changed, 6 insertions(+), 8 deletions(-)
diff --git a/kernel/rcu/tree.c b/kernel/rcu/tree.c
index f78ee759af9c..03c54c3478b7 100644
--- a/kernel/rcu/tree.c
+++ b/kernel/rcu/tree.c
@@ -3022,6 +3022,12 @@ struct kfree_rcu_cpu_work {
* @monitor_todo: Tracks whether a @monitor_work delayed work is pending
* @initialized: The @rcu_work fields have been initialized
* @count: Number of objects for which GP not started
+ * @bkvcache:
+ * A simple cache list that contains objects for reuse purpose.
+ * In order to save some per-cpu space the list is singular.
+ * Even though it is lockless an access has to be protected by the
+ * per-cpu lock.
+ * @nr_bkv_objs: number of allocated objects at @bkvcache.
*
* This is a per-CPU structure. The reason that it is not included in
* the rcu_data structure is to permit this code to be extracted from
@@ -3037,14 +3043,6 @@ struct kfree_rcu_cpu {
bool monitor_todo;
bool initialized;
int count;
-
- /*
- * A simple cache list that contains objects for
- * reuse purpose. In order to save some per-cpu
- * space the list is singular. Even though it is
- * lockless an access has to be protected by the
- * per-cpu lock.
- */
struct llist_head bkvcache;
int nr_bkv_objs;
};
--
2.26.2
There are some c-domain tags that are wrong. While this won't
cause problems with Sphinx < 3.0, this cause troubles with
newer versions, as the C parser won't recognize the contents
of the tag, and will drop it from the output.
Let's just place them at literal blocks.
Reviewed-by: Kamalesh Babulal <[email protected]>
Acked-by: Steven Rostedt (VMware) <[email protected]>
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/trace/ftrace-uses.rst | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/Documentation/trace/ftrace-uses.rst b/Documentation/trace/ftrace-uses.rst
index 2a05e770618a..a4955f7e3d19 100644
--- a/Documentation/trace/ftrace-uses.rst
+++ b/Documentation/trace/ftrace-uses.rst
@@ -55,17 +55,17 @@ an ftrace_ops with ftrace:
Both .flags and .private are optional. Only .func is required.
-To enable tracing call:
+To enable tracing call::
-.. c:function:: register_ftrace_function(&ops);
+ register_ftrace_function(&ops);
-To disable tracing call:
+To disable tracing call::
-.. c:function:: unregister_ftrace_function(&ops);
+ unregister_ftrace_function(&ops);
-The above is defined by including the header:
+The above is defined by including the header::
-.. c:function:: #include <linux/ftrace.h>
+ #include <linux/ftrace.h>
The registered callback will start being called some time after the
register_ftrace_function() is called and before it returns. The exact time
--
2.26.2
Changeset 129134e5415d ("media: media/v4l2: remove V4L2_FLAG_MEMORY_NON_CONSISTENT flag")
reverted an uAPI flag, but it kept some left-overs at the documentation.
Drop them too. This should solve this warning:
Documentation/userspace-api/media/v4l/buffer.rst:692: WARNING: The "flat-table" directive is empty; content required.
.. flat-table::
:header-rows: 0
:stub-columns: 0
:widths: 3 1 4
Fixes: 129134e5415d ("media: media/v4l2: remove V4L2_FLAG_MEMORY_NON_CONSISTENT flag")
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/userspace-api/media/v4l/buffer.rst | 14 --------------
1 file changed, 14 deletions(-)
diff --git a/Documentation/userspace-api/media/v4l/buffer.rst b/Documentation/userspace-api/media/v4l/buffer.rst
index 8be62dcffbb2..7dbdfbb4a0a9 100644
--- a/Documentation/userspace-api/media/v4l/buffer.rst
+++ b/Documentation/userspace-api/media/v4l/buffer.rst
@@ -678,20 +678,6 @@ Buffer Flags
.. _memory-flags:
-Memory Consistency Flags
-========================
-
-.. tabularcolumns:: |p{7.0cm}|p{2.2cm}|p{8.3cm}|
-
-.. cssclass:: longtable
-
-.. flat-table::
- :header-rows: 0
- :stub-columns: 0
- :widths: 3 1 4
-
-.. c:type:: v4l2_memory
-
enum v4l2_memory
================
--
2.26.2
As there's already a rst file with workqueue markups, containing
part of them, move the other definitions, in order to avoid
warnings with Sphinx.
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/core-api/workqueue.rst | 2 ++
Documentation/driver-api/basics.rst | 9 ---------
2 files changed, 2 insertions(+), 9 deletions(-)
diff --git a/Documentation/core-api/workqueue.rst b/Documentation/core-api/workqueue.rst
index 00a5ba51e63f..541d31de8926 100644
--- a/Documentation/core-api/workqueue.rst
+++ b/Documentation/core-api/workqueue.rst
@@ -396,3 +396,5 @@ Kernel Inline Documentations Reference
======================================
.. kernel-doc:: include/linux/workqueue.h
+
+.. kernel-doc:: kernel/workqueue.c
diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api/basics.rst
index 1ba88c7b3984..54f8d5ca7475 100644
--- a/Documentation/driver-api/basics.rst
+++ b/Documentation/driver-api/basics.rst
@@ -55,15 +55,6 @@ High-resolution timers
.. kernel-doc:: kernel/time/hrtimer.c
:export:
-Workqueues and Kevents
-----------------------
-
-.. kernel-doc:: include/linux/workqueue.h
- :internal:
-
-.. kernel-doc:: kernel/workqueue.c
- :export:
-
Internal Functions
------------------
--
2.26.2
Finding where an error like this was generated:
../lib/math/div64.c:73: WARNING: Duplicate C declaration, also defined in 'kernel-api'.
Can take some time, as there's no glue about what kernel-doc
tag generated it. It is a way better to display it as:
.../Documentation/core-api/kernel-api:171: ../lib/math/div64.c:73: WARNING: Duplicate C declaration, also defined in 'kernel-api'.
Declaration is 'div_s64_rem'.
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/sphinx/kerneldoc.py | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerneldoc.py
index 1a1b12242a45..a3a5427130da 100644
--- a/Documentation/sphinx/kerneldoc.py
+++ b/Documentation/sphinx/kerneldoc.py
@@ -141,7 +141,8 @@ class KernelDocDirective(Directive):
lineoffset = int(match.group(1)) - 1
# we must eat our comments since the upset the markup
else:
- result.append(line, filename, lineoffset)
+ doc = env.srcdir + "/" + env.docname + ":" + str(self.lineno)
+ result.append(line, doc + ": " + filename, lineoffset)
lineoffset += 1
node = nodes.section()
--
2.26.2
From: Nícolas F. R. A. Prado <[email protected]>
While Sphinx 2 used a single c:type role for struct, union, enum and
typedef, Sphinx 3 uses a specific role for each one.
To keep backward compatibility, detect the Sphinx version and use the
correct roles for that version.
Also, Sphinx 3 is more strict with its C domain and generated warnings,
exposing issues in the parsing.
To fix the warnings, make the C regexes use ASCII, ensure the
expressions only match the beginning of words and skip trying to
cross-reference C reserved words.
Signed-off-by: Nícolas F. R. A. Prado <[email protected]>
Signed-off-by: Mauro Carvalho Chehab <[email protected]>
---
Documentation/sphinx/automarkup.py | 69 ++++++++++++++++++++++++++----
1 file changed, 60 insertions(+), 9 deletions(-)
diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/automarkup.py
index a1b0f554cd82..fd1e927408ad 100644
--- a/Documentation/sphinx/automarkup.py
+++ b/Documentation/sphinx/automarkup.py
@@ -22,13 +22,34 @@ from itertools import chain
# :c:func: block (i.e. ":c:func:`mmap()`s" flakes out), so the last
# bit tries to restrict matches to things that won't create trouble.
#
-RE_function = re.compile(r'(([\w_][\w\d_]+)\(\))')
-RE_type = re.compile(r'(struct|union|enum|typedef)\s+([\w_][\w\d_]+)')
+RE_function = re.compile(r'\b(([a-zA-Z_]\w+)\(\))', flags=re.ASCII)
+
+#
+# Sphinx 2 uses the same :c:type role for struct, union, enum and typedef
+#
+RE_generic_type = re.compile(r'\b(struct|union|enum|typedef)\s+([a-zA-Z_]\w+)',
+ flags=re.ASCII)
+
+#
+# Sphinx 3 uses a different C role for each one of struct, union, enum and
+# typedef
+#
+RE_struct = re.compile(r'\b(struct)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
+RE_union = re.compile(r'\b(union)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
+RE_enum = re.compile(r'\b(enum)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
+RE_typedef = re.compile(r'\b(typedef)\s+([a-zA-Z_]\w+)', flags=re.ASCII)
+
#
# Detects a reference to a documentation page of the form Documentation/... with
# an optional extension
#
-RE_doc = re.compile(r'Documentation(/[\w\-_/]+)(\.\w+)*')
+RE_doc = re.compile(r'\bDocumentation(/[\w\-_/]+)(\.\w+)*')
+
+#
+# Reserved C words that we should skip when cross-referencing
+#
+Skipnames = [ 'for', 'if', 'register', 'sizeof', 'struct', 'unsigned' ]
+
#
# Many places in the docs refer to common system calls. It is
@@ -48,9 +69,22 @@ def markup_refs(docname, app, node):
#
# Associate each regex with the function that will markup its matches
#
- markup_func = {RE_type: markup_c_ref,
- RE_function: markup_c_ref,
- RE_doc: markup_doc_ref}
+ markup_func_sphinx2 = {RE_doc: markup_doc_ref,
+ RE_function: markup_c_ref,
+ RE_generic_type: markup_c_ref}
+
+ markup_func_sphinx3 = {RE_doc: markup_doc_ref,
+ RE_function: markup_c_ref,
+ RE_struct: markup_c_ref,
+ RE_union: markup_c_ref,
+ RE_enum: markup_c_ref,
+ RE_typedef: markup_c_ref}
+
+ if sphinx.__version__[0] == '3':
+ markup_func = markup_func_sphinx3
+ else:
+ markup_func = markup_func_sphinx2
+
match_iterators = [regex.finditer(t) for regex in markup_func]
#
# Sort all references by the starting position in text
@@ -79,8 +113,24 @@ def markup_refs(docname, app, node):
# type_name) with an appropriate cross reference.
#
def markup_c_ref(docname, app, match):
- class_str = {RE_function: 'c-func', RE_type: 'c-type'}
- reftype_str = {RE_function: 'function', RE_type: 'type'}
+ class_str = {RE_function: 'c-func',
+ # Sphinx 2 only
+ RE_generic_type: 'c-type',
+ # Sphinx 3+ only
+ RE_struct: 'c-struct',
+ RE_union: 'c-union',
+ RE_enum: 'c-enum',
+ RE_typedef: 'c-type',
+ }
+ reftype_str = {RE_function: 'function',
+ # Sphinx 2 only
+ RE_generic_type: 'type',
+ # Sphinx 3+ only
+ RE_struct: 'struct',
+ RE_union: 'union',
+ RE_enum: 'enum',
+ RE_typedef: 'type',
+ }
cdom = app.env.domains['c']
#
@@ -89,7 +139,8 @@ def markup_c_ref(docname, app, match):
target = match.group(2)
target_text = nodes.Text(match.group(0))
xref = None
- if not (match.re == RE_function and target in Skipfuncs):
+ if not ((match.re == RE_function and target in Skipfuncs)
+ or (target in Skipnames)):
lit_text = nodes.literal(classes=['xref', 'c', class_str[match.re]])
lit_text += target_text
pxref = addnodes.pending_xref('', refdomain = 'c',
--
2.26.2
On Tue, Oct 13, 2020 at 01:54:25PM +0200, Mauro Carvalho Chehab wrote:
> Changeset 53c72b590b3a ("rcu/tree: cache specified number of objects")
> added new members for struct kfree_rcu_cpu, but didn't add the
> corresponding at the kernel-doc markup, as repoted when doing
> "make htmldocs":
> ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'bkvcache' not described in 'kfree_rcu_cpu'
> ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'nr_bkv_objs' not described in 'kfree_rcu_cpu'
>
> So, move the description for bkvcache to kernel-doc, and add a
> description for nr_bkv_objs.
>
> Fixes: 53c72b590b3a ("rcu/tree: cache specified number of objects")
> Signed-off-by: Mauro Carvalho Chehab <[email protected]>
Queued for review and testing, likely target v5.11.
Thanx, Paul
> ---
> kernel/rcu/tree.c | 14 ++++++--------
> 1 file changed, 6 insertions(+), 8 deletions(-)
>
> diff --git a/kernel/rcu/tree.c b/kernel/rcu/tree.c
> index f78ee759af9c..03c54c3478b7 100644
> --- a/kernel/rcu/tree.c
> +++ b/kernel/rcu/tree.c
> @@ -3022,6 +3022,12 @@ struct kfree_rcu_cpu_work {
> * @monitor_todo: Tracks whether a @monitor_work delayed work is pending
> * @initialized: The @rcu_work fields have been initialized
> * @count: Number of objects for which GP not started
> + * @bkvcache:
> + * A simple cache list that contains objects for reuse purpose.
> + * In order to save some per-cpu space the list is singular.
> + * Even though it is lockless an access has to be protected by the
> + * per-cpu lock.
> + * @nr_bkv_objs: number of allocated objects at @bkvcache.
> *
> * This is a per-CPU structure. The reason that it is not included in
> * the rcu_data structure is to permit this code to be extracted from
> @@ -3037,14 +3043,6 @@ struct kfree_rcu_cpu {
> bool monitor_todo;
> bool initialized;
> int count;
> -
> - /*
> - * A simple cache list that contains objects for
> - * reuse purpose. In order to save some per-cpu
> - * space the list is singular. Even though it is
> - * lockless an access has to be protected by the
> - * per-cpu lock.
> - */
> struct llist_head bkvcache;
> int nr_bkv_objs;
> };
> --
> 2.26.2
>
Em Tue, 13 Oct 2020 09:34:04 -0700
"Paul E. McKenney" <[email protected]> escreveu:
> On Tue, Oct 13, 2020 at 01:54:25PM +0200, Mauro Carvalho Chehab wrote:
> > Changeset 53c72b590b3a ("rcu/tree: cache specified number of objects")
> > added new members for struct kfree_rcu_cpu, but didn't add the
> > corresponding at the kernel-doc markup, as repoted when doing
> > "make htmldocs":
> > ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'bkvcache' not described in 'kfree_rcu_cpu'
> > ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'nr_bkv_objs' not described in 'kfree_rcu_cpu'
> >
> > So, move the description for bkvcache to kernel-doc, and add a
> > description for nr_bkv_objs.
> >
> > Fixes: 53c72b590b3a ("rcu/tree: cache specified number of objects")
> > Signed-off-by: Mauro Carvalho Chehab <[email protected]>
>
> Queued for review and testing, likely target v5.11.
Hi Paul,
I would prefer if we could get those on 5.10, if possible.
We're aiming to have 5.10 free of docs warnings ;-)
If you prefer, I can send those patches to Linus with your
ack.
Regards,
Mauro
>
> Thanx, Paul
>
> > ---
> > kernel/rcu/tree.c | 14 ++++++--------
> > 1 file changed, 6 insertions(+), 8 deletions(-)
> >
> > diff --git a/kernel/rcu/tree.c b/kernel/rcu/tree.c
> > index f78ee759af9c..03c54c3478b7 100644
> > --- a/kernel/rcu/tree.c
> > +++ b/kernel/rcu/tree.c
> > @@ -3022,6 +3022,12 @@ struct kfree_rcu_cpu_work {
> > * @monitor_todo: Tracks whether a @monitor_work delayed work is pending
> > * @initialized: The @rcu_work fields have been initialized
> > * @count: Number of objects for which GP not started
> > + * @bkvcache:
> > + * A simple cache list that contains objects for reuse purpose.
> > + * In order to save some per-cpu space the list is singular.
> > + * Even though it is lockless an access has to be protected by the
> > + * per-cpu lock.
> > + * @nr_bkv_objs: number of allocated objects at @bkvcache.
> > *
> > * This is a per-CPU structure. The reason that it is not included in
> > * the rcu_data structure is to permit this code to be extracted from
> > @@ -3037,14 +3043,6 @@ struct kfree_rcu_cpu {
> > bool monitor_todo;
> > bool initialized;
> > int count;
> > -
> > - /*
> > - * A simple cache list that contains objects for
> > - * reuse purpose. In order to save some per-cpu
> > - * space the list is singular. Even though it is
> > - * lockless an access has to be protected by the
> > - * per-cpu lock.
> > - */
> > struct llist_head bkvcache;
> > int nr_bkv_objs;
> > };
> > --
> > 2.26.2
> >
Thanks,
Mauro
On Tue, Oct 13, 2020 at 10:46:08PM +0200, Mauro Carvalho Chehab wrote:
> Em Tue, 13 Oct 2020 09:34:04 -0700
> "Paul E. McKenney" <[email protected]> escreveu:
>
> > On Tue, Oct 13, 2020 at 01:54:25PM +0200, Mauro Carvalho Chehab wrote:
> > > Changeset 53c72b590b3a ("rcu/tree: cache specified number of objects")
> > > added new members for struct kfree_rcu_cpu, but didn't add the
> > > corresponding at the kernel-doc markup, as repoted when doing
> > > "make htmldocs":
> > > ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'bkvcache' not described in 'kfree_rcu_cpu'
> > > ./kernel/rcu/tree.c:3113: warning: Function parameter or member 'nr_bkv_objs' not described in 'kfree_rcu_cpu'
> > >
> > > So, move the description for bkvcache to kernel-doc, and add a
> > > description for nr_bkv_objs.
> > >
> > > Fixes: 53c72b590b3a ("rcu/tree: cache specified number of objects")
> > > Signed-off-by: Mauro Carvalho Chehab <[email protected]>
> >
> > Queued for review and testing, likely target v5.11.
>
> Hi Paul,
>
> I would prefer if we could get those on 5.10, if possible.
> We're aiming to have 5.10 free of docs warnings ;-)
>
> If you prefer, I can send those patches to Linus with your
> ack.
That sounds easier:
Acked-by: Paul E. McKenney <[email protected]>
Alan's objection is quite valid, but we will address that issue in a
follow-on patch that will not be on the fast track.
Thanx, Paul
> Regards,
> Mauro
>
> >
> > Thanx, Paul
> >
> > > ---
> > > kernel/rcu/tree.c | 14 ++++++--------
> > > 1 file changed, 6 insertions(+), 8 deletions(-)
> > >
> > > diff --git a/kernel/rcu/tree.c b/kernel/rcu/tree.c
> > > index f78ee759af9c..03c54c3478b7 100644
> > > --- a/kernel/rcu/tree.c
> > > +++ b/kernel/rcu/tree.c
> > > @@ -3022,6 +3022,12 @@ struct kfree_rcu_cpu_work {
> > > * @monitor_todo: Tracks whether a @monitor_work delayed work is pending
> > > * @initialized: The @rcu_work fields have been initialized
> > > * @count: Number of objects for which GP not started
> > > + * @bkvcache:
> > > + * A simple cache list that contains objects for reuse purpose.
> > > + * In order to save some per-cpu space the list is singular.
> > > + * Even though it is lockless an access has to be protected by the
> > > + * per-cpu lock.
> > > + * @nr_bkv_objs: number of allocated objects at @bkvcache.
> > > *
> > > * This is a per-CPU structure. The reason that it is not included in
> > > * the rcu_data structure is to permit this code to be extracted from
> > > @@ -3037,14 +3043,6 @@ struct kfree_rcu_cpu {
> > > bool monitor_todo;
> > > bool initialized;
> > > int count;
> > > -
> > > - /*
> > > - * A simple cache list that contains objects for
> > > - * reuse purpose. In order to save some per-cpu
> > > - * space the list is singular. Even though it is
> > > - * lockless an access has to be protected by the
> > > - * per-cpu lock.
> > > - */
> > > struct llist_head bkvcache;
> > > int nr_bkv_objs;
> > > };
> > > --
> > > 2.26.2
> > >
>
>
>
> Thanks,
> Mauro
On Tue, Oct 13, 2020 at 01:53:15PM +0200, Mauro Carvalho Chehab wrote:
> This series actually folds the previous Sphinx 3.x patch series
> with the other patches I sent fixing warnings with Sphinx
> 2.x and with kernel-doc and that weren't merged yet via
> some other tree.
>
> It is based on the top of upstream, plus the media
> pull request I sent yesterday:
>
> https://lore.kernel.org/lkml/[email protected]/
>
> My plan is to send a pull request with those patches after Thursday's
> linux next release.
>
> On this series, I removed the patches that depend on material
> currently found only at linux-next.
Was a bit tricky to find the cover letter here and that you plan to
send these out this merge window. I think we'll have some confusion
now with Alex from amd having picked up a few already.
Anyway Acked-by: Daniel Vetter <[email protected]> for the
remaining drm patches. Although I can also pick them up to
drm-misc-next (but that's going to be 5.11 or so).
-Daniel
>
> Mauro Carvalho Chehab (79):
> scripts: kernel-doc: add support for typedef enum
> scripts: kernel-doc: make it more compatible with Sphinx 3.x
> scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx
> 3.x
> scripts: kernel-doc: fix troubles with line counts
> scripts: kernel-doc: reimplement -nofunction argument
> scripts: kernel-doc: fix typedef identification
> scripts: kernel-doc: don't mangle with parameter list
> scripts: kernel-doc: allow passing desired Sphinx C domain dialect
> scripts: kernel-doc: fix line number handling
> scripts: kernel-doc: try to use c:function if possible
> docs: cdomain.py: add support for a new Sphinx 3.1+ tag
> docs: cdomain.py: extend it to handle new Sphinx 3.x tags
> docs: kerneldoc.py: append the name of the parsed doc file
> docs: kerneldoc.py: add support for kerneldoc -nosymbol
> media: docs: make CEC documents compatible with Sphinx 3.1+
> media: docs: make V4L documents more compatible with Sphinx 3.1+
> media: docs: make DVB documents more compatible with Sphinx 3.1+
> media: docs: make MC documents more compatible with Sphinx 3.1+
> media: docs: make RC documents more compatible with Sphinx 3.1+
> media: cec-core.rst: don't use c:type for structs
> docs: remove some replace macros like |struct foo|
> docs: get rid of :c:type explicit declarations for structs
> docs: trace-uses.rst: remove bogus c-domain tags
> docs: it_IT: fix namespace collisions at locking.rst
> docs: net: ieee802154.rst: fix C expressions
> docs: genericirq.rst: don't document chip.c functions twice
> docs: kernel-api.rst: drop kernel/irq/manage.c kernel-doc tag
> docs: remove sound API duplication
> docs: basics.rst: move kernel-doc workqueue markups to workqueue.rst
> docs: scsi: target.rst: remove iSCSI transport class kernel-doc markup
> docs: device_link.rst: remove duplicated kernel-doc include
> docs: basics.rst: get rid of rcu kernel-doc macros
> docs: pstore-blk.rst: fix kernel-doc tags
> docs: fs: fscrypt.rst: get rid of :c:type: tags
> docs: devices.rst: get rid of :c:type macros
> docs: sound: writing-an-alsa-driver.rst: get rid of :c:type
> docs: block: blk-mq.rst: get rid of :c:type
> docs: writing-an-alsa-driver.rst: fix some bad c:func: markups
> docs: fpga: replace :c:member: macros
> docs: kgdb.rst: fix :c:type: usages
> docs: libata.rst: fix a wrong usage of :c:type: tag
> docs: infrastructure.rst: don't include firmware kernel-doc
> docs: gpu: i915.rst: Fix several C duplication warnings
> docs: devices.rst: fix a C reference markup
> docs: it_IT: hacking.rst: fix a typo on a markup
> docs: mei.rst: fix a C expression markup
> docs: basics.rst: avoid duplicated C function declaration
> docs: conf.py: fix c:function support with Sphinx 3.x
> docs: conf.py: change the Sphinx 3.x+ text
> docs: infrastructure.rst: exclude device_link_state from device.h
> docs: zh_CN: amu.rst: fix document title markup
> media: uAPI: buffer.rst: remove a left-over documentation
> math64.h: kernel-docs: Convert some markups into normal comments
> memblock: get rid of a :c:type leftover
> dt-bindings: fix references to files converted to yaml
> net: appletalk: Kconfig: Fix docs location
> drivers: net: hamradio: fix document location
> docs: powerpc: syscall64-abi.rst: fix a malformed table
> block: bio: fix a warning at the kernel-doc markups
> kunit: test.h: solve kernel-doc warnings
> docs: bio: fix a kerneldoc markup
> drivers: core: fix kernel-doc markup for dev_err_probe()
> kunit: test.h: fix a bad kernel-doc markup
> docs: amdgpu: fix a warning when building the documentation
> locking/refcount: document the new "oldp" pointer value
> usb: docs: document altmode register/unregister functions
> nl80211: docs: add a description for s1g_cap parameter
> IB/srpt: docs: add a description for cq_size member
> rcu/tree: docs: document bkvcache new members at struct kfree_rcu_cpu
> Input: sparse-keymap: add a description for @sw
> drm/amd/display: kernel-doc: document force_timing_sync
> drm: kernel-doc: drm_dp_helper.h: fix a typo
> gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markups
> drm: kernel-doc: add description for a new function parameter
> docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup
> workqueue: fix a kernel-doc warning
> mm/doc: fix a literal block markup
> drm: drm_edid: remove a duplicated kernel-doc declaration
> PM / devfreq: remove a duplicated kernel-doc markup
>
> Nícolas F. R. A. Prado (1):
> docs: automarkup.py: make it ready for Sphinx 3.1+
>
> Documentation/admin-guide/pm/cpufreq.rst | 11 +-
> Documentation/admin-guide/pstore-blk.rst | 10 +-
> Documentation/block/blk-mq.rst | 12 +-
> Documentation/block/inline-encryption.rst | 8 +-
> Documentation/conf.py | 65 +++-
> Documentation/core-api/genericirq.rst | 2 +
> Documentation/core-api/kernel-api.rst | 6 -
> Documentation/core-api/workqueue.rst | 2 +
> Documentation/dev-tools/kgdb.rst | 6 +-
> .../bindings/display/tilcdc/tilcdc.txt | 2 +-
> .../bindings/mailbox/omap-mailbox.txt | 2 +-
> .../devicetree/bindings/media/i2c/tvp5150.txt | 2 +-
> .../bindings/pwm/google,cros-ec-pwm.yaml | 2 +-
> .../bindings/soc/qcom/qcom,smd-rpm.yaml | 2 +-
> .../bindings/sound/google,cros-ec-codec.yaml | 2 +-
> Documentation/doc-guide/kernel-doc.rst | 8 +
> Documentation/driver-api/basics.rst | 19 +-
> Documentation/driver-api/device_link.rst | 13 +-
> Documentation/driver-api/fpga/fpga-bridge.rst | 4 +-
> Documentation/driver-api/fpga/fpga-mgr.rst | 6 +-
> .../driver-api/fpga/fpga-programming.rst | 2 +-
> Documentation/driver-api/fpga/fpga-region.rst | 6 +-
> Documentation/driver-api/iio/buffers.rst | 2 +-
> Documentation/driver-api/iio/core.rst | 6 +-
> Documentation/driver-api/iio/hw-consumer.rst | 2 +-
> .../driver-api/iio/triggered-buffers.rst | 2 +-
> Documentation/driver-api/iio/triggers.rst | 4 +-
> Documentation/driver-api/index.rst | 1 -
> Documentation/driver-api/infrastructure.rst | 4 +-
> Documentation/driver-api/libata.rst | 2 +-
> Documentation/driver-api/media/cec-core.rst | 2 +-
> .../driver-api/media/dtv-frontend.rst | 4 +-
> Documentation/driver-api/media/mc-core.rst | 24 +-
> .../driver-api/media/v4l2-controls.rst | 2 +-
> Documentation/driver-api/media/v4l2-dev.rst | 8 +-
> .../driver-api/media/v4l2-device.rst | 6 +-
> Documentation/driver-api/media/v4l2-event.rst | 10 +-
> Documentation/driver-api/media/v4l2-fh.rst | 16 +-
> .../driver-api/media/v4l2-subdev.rst | 2 +-
> Documentation/driver-api/mei/mei.rst | 2 +-
> Documentation/driver-api/pm/cpuidle.rst | 65 ++--
> Documentation/driver-api/pm/devices.rst | 26 +-
> Documentation/driver-api/regulator.rst | 4 +-
> Documentation/driver-api/sound.rst | 54 ----
> Documentation/driver-api/target.rst | 12 -
> Documentation/driver-api/usb/URB.rst | 2 +-
> Documentation/driver-api/usb/gadget.rst | 10 +-
> Documentation/driver-api/usb/hotplug.rst | 2 +-
> Documentation/driver-api/usb/typec_bus.rst | 8 +-
> Documentation/filesystems/fscrypt.rst | 61 ++--
> Documentation/filesystems/fsverity.rst | 2 +-
> Documentation/gpu/amdgpu.rst | 11 +-
> Documentation/gpu/i915.rst | 29 +-
> Documentation/networking/ieee802154.rst | 18 +-
> Documentation/powerpc/syscall64-abi.rst | 32 +-
> Documentation/sound/designs/tracepoints.rst | 22 +-
> .../sound/kernel-api/alsa-driver-api.rst | 1 +
> .../kernel-api/writing-an-alsa-driver.rst | 110 +++----
> Documentation/sphinx/automarkup.py | 69 +++-
> Documentation/sphinx/cdomain.py | 93 +++++-
> Documentation/sphinx/kerneldoc.py | 15 +-
> Documentation/sphinx/parse-headers.pl | 2 +-
> Documentation/trace/ftrace-uses.rst | 12 +-
> .../it_IT/kernel-hacking/hacking.rst | 2 +-
> .../it_IT/kernel-hacking/locking.rst | 2 +
> .../translations/zh_CN/arm64/amu.rst | 4 +-
> .../media/cec/cec-func-close.rst | 10 +-
> .../media/cec/cec-func-ioctl.rst | 11 +-
> .../userspace-api/media/cec/cec-func-open.rst | 10 +-
> .../userspace-api/media/cec/cec-func-poll.rst | 14 +-
> .../media/cec/cec-ioc-adap-g-caps.rst | 10 +-
> .../media/cec/cec-ioc-adap-g-conn-info.rst | 11 +-
> .../media/cec/cec-ioc-adap-g-log-addrs.rst | 20 +-
> .../media/cec/cec-ioc-adap-g-phys-addr.rst | 15 +-
> .../media/cec/cec-ioc-dqevent.rst | 15 +-
> .../media/cec/cec-ioc-g-mode.rst | 16 +-
> .../media/cec/cec-ioc-receive.rst | 18 +-
> .../dvb/audio-bilingual-channel-select.rst | 7 +-
> .../media/dvb/audio-channel-select.rst | 8 +-
> .../media/dvb/audio-clear-buffer.rst | 8 +-
> .../media/dvb/audio-continue.rst | 7 +-
> .../userspace-api/media/dvb/audio-fclose.rst | 7 +-
> .../userspace-api/media/dvb/audio-fopen.rst | 7 +-
> .../userspace-api/media/dvb/audio-fwrite.rst | 7 +-
> .../media/dvb/audio-get-capabilities.rst | 8 +-
> .../media/dvb/audio-get-status.rst | 8 +-
> .../userspace-api/media/dvb/audio-pause.rst | 9 +-
> .../userspace-api/media/dvb/audio-play.rst | 7 +-
> .../media/dvb/audio-select-source.rst | 8 +-
> .../media/dvb/audio-set-av-sync.rst | 8 +-
> .../media/dvb/audio-set-bypass-mode.rst | 9 +-
> .../userspace-api/media/dvb/audio-set-id.rst | 9 +-
> .../media/dvb/audio-set-mixer.rst | 9 +-
> .../media/dvb/audio-set-mute.rst | 8 +-
> .../media/dvb/audio-set-streamtype.rst | 10 +-
> .../userspace-api/media/dvb/audio-stop.rst | 9 +-
> .../userspace-api/media/dvb/ca-fclose.rst | 7 +-
> .../userspace-api/media/dvb/ca-fopen.rst | 7 +-
> .../userspace-api/media/dvb/ca-get-cap.rst | 8 +-
> .../media/dvb/ca-get-descr-info.rst | 9 +-
> .../userspace-api/media/dvb/ca-get-msg.rst | 10 +-
> .../media/dvb/ca-get-slot-info.rst | 9 +-
> .../userspace-api/media/dvb/ca-reset.rst | 9 +-
> .../userspace-api/media/dvb/ca-send-msg.rst | 9 +-
> .../userspace-api/media/dvb/ca-set-descr.rst | 8 +-
> .../userspace-api/media/dvb/dmx-add-pid.rst | 10 +-
> .../userspace-api/media/dvb/dmx-expbuf.rst | 11 +-
> .../userspace-api/media/dvb/dmx-fclose.rst | 9 +-
> .../userspace-api/media/dvb/dmx-fopen.rst | 5 +-
> .../userspace-api/media/dvb/dmx-fread.rst | 7 +-
> .../userspace-api/media/dvb/dmx-fwrite.rst | 6 +-
> .../media/dvb/dmx-get-pes-pids.rst | 12 +-
> .../userspace-api/media/dvb/dmx-get-stc.rst | 12 +-
> .../userspace-api/media/dvb/dmx-mmap.rst | 15 +-
> .../userspace-api/media/dvb/dmx-munmap.rst | 14 +-
> .../userspace-api/media/dvb/dmx-qbuf.rst | 17 +-
> .../userspace-api/media/dvb/dmx-querybuf.rst | 9 +-
> .../media/dvb/dmx-remove-pid.rst | 10 +-
> .../userspace-api/media/dvb/dmx-reqbufs.rst | 9 +-
> .../media/dvb/dmx-set-buffer-size.rst | 10 +-
> .../media/dvb/dmx-set-filter.rst | 12 +-
> .../media/dvb/dmx-set-pes-filter.rst | 13 +-
> .../userspace-api/media/dvb/dmx-start.rst | 11 +-
> .../userspace-api/media/dvb/dmx-stop.rst | 9 +-
> .../media/dvb/fe-diseqc-recv-slave-reply.rst | 9 +-
> .../media/dvb/fe-diseqc-reset-overload.rst | 9 +-
> .../media/dvb/fe-diseqc-send-burst.rst | 10 +-
> .../media/dvb/fe-diseqc-send-master-cmd.rst | 9 +-
> .../dvb/fe-dishnetwork-send-legacy-cmd.rst | 10 +-
> .../media/dvb/fe-enable-high-lnb-voltage.rst | 10 +-
> .../userspace-api/media/dvb/fe-get-event.rst | 12 +-
> .../media/dvb/fe-get-frontend.rst | 12 +-
> .../userspace-api/media/dvb/fe-get-info.rst | 11 +-
> .../media/dvb/fe-get-property.rst | 15 +-
> .../userspace-api/media/dvb/fe-read-ber.rst | 9 +-
> .../media/dvb/fe-read-signal-strength.rst | 9 +-
> .../userspace-api/media/dvb/fe-read-snr.rst | 9 +-
> .../media/dvb/fe-read-status.rst | 11 +-
> .../media/dvb/fe-read-uncorrected-blocks.rst | 9 +-
> .../media/dvb/fe-set-frontend-tune-mode.rst | 10 +-
> .../media/dvb/fe-set-frontend.rst | 11 +-
> .../userspace-api/media/dvb/fe-set-tone.rst | 10 +-
> .../media/dvb/fe-set-voltage.rst | 10 +-
> .../media/dvb/frontend_f_close.rst | 8 +-
> .../media/dvb/frontend_f_open.rst | 10 +-
> .../userspace-api/media/dvb/net-add-if.rst | 9 +-
> .../userspace-api/media/dvb/net-get-if.rst | 10 +-
> .../userspace-api/media/dvb/net-remove-if.rst | 10 +-
> .../media/dvb/video-clear-buffer.rst | 8 +-
> .../userspace-api/media/dvb/video-command.rst | 10 +-
> .../media/dvb/video-continue.rst | 8 +-
> .../media/dvb/video-fast-forward.rst | 10 +-
> .../userspace-api/media/dvb/video-fclose.rst | 6 +-
> .../userspace-api/media/dvb/video-fopen.rst | 6 +-
> .../userspace-api/media/dvb/video-freeze.rst | 8 +-
> .../userspace-api/media/dvb/video-fwrite.rst | 6 +-
> .../media/dvb/video-get-capabilities.rst | 8 +-
> .../media/dvb/video-get-event.rst | 8 +-
> .../media/dvb/video-get-frame-count.rst | 8 +-
> .../userspace-api/media/dvb/video-get-pts.rst | 8 +-
> .../media/dvb/video-get-size.rst | 8 +-
> .../media/dvb/video-get-status.rst | 7 +-
> .../userspace-api/media/dvb/video-play.rst | 8 +-
> .../media/dvb/video-select-source.rst | 7 +-
> .../media/dvb/video-set-blank.rst | 8 +-
> .../media/dvb/video-set-display-format.rst | 8 +-
> .../media/dvb/video-set-format.rst | 9 +-
> .../media/dvb/video-set-streamtype.rst | 8 +-
> .../media/dvb/video-slowmotion.rst | 10 +-
> .../media/dvb/video-stillpicture.rst | 8 +-
> .../userspace-api/media/dvb/video-stop.rst | 8 +-
> .../media/dvb/video-try-command.rst | 8 +-
> .../media/mediactl/media-func-close.rst | 10 +-
> .../media/mediactl/media-func-ioctl.rst | 10 +-
> .../media/mediactl/media-func-open.rst | 10 +-
> .../media/mediactl/media-ioc-device-info.rst | 13 +-
> .../mediactl/media-ioc-enum-entities.rst | 11 +-
> .../media/mediactl/media-ioc-enum-links.rst | 13 +-
> .../media/mediactl/media-ioc-g-topology.rst | 14 +-
> .../mediactl/media-ioc-request-alloc.rst | 11 +-
> .../media/mediactl/media-ioc-setup-link.rst | 10 +-
> .../mediactl/media-request-ioc-queue.rst | 7 +-
> .../mediactl/media-request-ioc-reinit.rst | 8 +-
> .../media/mediactl/request-api.rst | 5 +-
> .../media/mediactl/request-func-close.rst | 8 +-
> .../media/mediactl/request-func-ioctl.rst | 8 +-
> .../media/mediactl/request-func-poll.rst | 12 +-
> .../media/rc/lirc-get-features.rst | 9 +-
> .../media/rc/lirc-get-rec-mode.rst | 12 +-
> .../media/rc/lirc-get-rec-resolution.rst | 8 +-
> .../media/rc/lirc-get-send-mode.rst | 14 +-
> .../media/rc/lirc-get-timeout.rst | 13 +-
> .../userspace-api/media/rc/lirc-read.rst | 10 +-
> .../rc/lirc-set-measure-carrier-mode.rst | 8 +-
> .../media/rc/lirc-set-rec-carrier-range.rst | 6 +-
> .../media/rc/lirc-set-rec-carrier.rst | 8 +-
> .../media/rc/lirc-set-rec-timeout-reports.rst | 8 +-
> .../media/rc/lirc-set-rec-timeout.rst | 13 +-
> .../media/rc/lirc-set-send-carrier.rst | 8 +-
> .../media/rc/lirc-set-send-duty-cycle.rst | 8 +-
> .../media/rc/lirc-set-transmitter-mask.rst | 8 +-
> .../media/rc/lirc-set-wideband-receiver.rst | 8 +-
> .../userspace-api/media/rc/lirc-write.rst | 7 +-
> .../userspace-api/media/v4l/buffer.rst | 28 +-
> .../userspace-api/media/v4l/dev-capture.rst | 7 +-
> .../userspace-api/media/v4l/dev-output.rst | 7 +-
> .../userspace-api/media/v4l/dev-raw-vbi.rst | 19 +-
> .../userspace-api/media/v4l/dev-rds.rst | 12 +-
> .../media/v4l/dev-sliced-vbi.rst | 31 +-
> .../userspace-api/media/v4l/diff-v4l.rst | 39 +--
> .../userspace-api/media/v4l/dmabuf.rst | 8 +-
> .../userspace-api/media/v4l/format.rst | 7 +-
> .../userspace-api/media/v4l/func-close.rst | 8 +-
> .../userspace-api/media/v4l/func-ioctl.rst | 10 +-
> .../userspace-api/media/v4l/func-mmap.rst | 18 +-
> .../userspace-api/media/v4l/func-munmap.rst | 14 +-
> .../userspace-api/media/v4l/func-open.rst | 14 +-
> .../userspace-api/media/v4l/func-poll.rst | 40 ++-
> .../userspace-api/media/v4l/func-read.rst | 39 ++-
> .../userspace-api/media/v4l/func-select.rst | 42 ++-
> .../userspace-api/media/v4l/func-write.rst | 13 +-
> .../userspace-api/media/v4l/hist-v4l2.rst | 70 +---
> Documentation/userspace-api/media/v4l/io.rst | 6 +-
> .../media/v4l/libv4l-introduction.rst | 30 +-
> .../userspace-api/media/v4l/mmap.rst | 26 +-
> .../userspace-api/media/v4l/open.rst | 15 +-
> Documentation/userspace-api/media/v4l/rw.rst | 18 +-
> .../userspace-api/media/v4l/streaming-par.rst | 5 +-
> .../userspace-api/media/v4l/userp.rst | 11 +-
> .../media/v4l/vidioc-create-bufs.rst | 11 +-
> .../media/v4l/vidioc-cropcap.rst | 11 +-
> .../media/v4l/vidioc-dbg-g-chip-info.rst | 13 +-
> .../media/v4l/vidioc-dbg-g-register.rst | 18 +-
> .../media/v4l/vidioc-decoder-cmd.rst | 19 +-
> .../media/v4l/vidioc-dqevent.rst | 19 +-
> .../media/v4l/vidioc-dv-timings-cap.rst | 17 +-
> .../media/v4l/vidioc-encoder-cmd.rst | 25 +-
> .../media/v4l/vidioc-enum-dv-timings.rst | 16 +-
> .../media/v4l/vidioc-enum-fmt.rst | 12 +-
> .../media/v4l/vidioc-enum-frameintervals.rst | 15 +-
> .../media/v4l/vidioc-enum-framesizes.rst | 16 +-
> .../media/v4l/vidioc-enum-freq-bands.rst | 12 +-
> .../media/v4l/vidioc-enumaudio.rst | 10 +-
> .../media/v4l/vidioc-enumaudioout.rst | 10 +-
> .../media/v4l/vidioc-enuminput.rst | 14 +-
> .../media/v4l/vidioc-enumoutput.rst | 13 +-
> .../media/v4l/vidioc-enumstd.rst | 23 +-
> .../userspace-api/media/v4l/vidioc-expbuf.rst | 14 +-
> .../media/v4l/vidioc-g-audio.rst | 18 +-
> .../media/v4l/vidioc-g-audioout.rst | 16 +-
> .../userspace-api/media/v4l/vidioc-g-crop.rst | 16 +-
> .../userspace-api/media/v4l/vidioc-g-ctrl.rst | 16 +-
> .../media/v4l/vidioc-g-dv-timings.rst | 26 +-
> .../userspace-api/media/v4l/vidioc-g-edid.rst | 25 +-
> .../media/v4l/vidioc-g-enc-index.rst | 13 +-
> .../media/v4l/vidioc-g-ext-ctrls.rst | 21 +-
> .../userspace-api/media/v4l/vidioc-g-fbuf.rst | 18 +-
> .../userspace-api/media/v4l/vidioc-g-fmt.rst | 22 +-
> .../media/v4l/vidioc-g-frequency.rst | 16 +-
> .../media/v4l/vidioc-g-input.rst | 15 +-
> .../media/v4l/vidioc-g-jpegcomp.rst | 17 +-
> .../media/v4l/vidioc-g-modulator.rst | 17 +-
> .../media/v4l/vidioc-g-output.rst | 15 +-
> .../userspace-api/media/v4l/vidioc-g-parm.rst | 30 +-
> .../media/v4l/vidioc-g-priority.rst | 16 +-
> .../media/v4l/vidioc-g-selection.rst | 15 +-
> .../media/v4l/vidioc-g-sliced-vbi-cap.rst | 12 +-
> .../userspace-api/media/v4l/vidioc-g-std.rst | 24 +-
> .../media/v4l/vidioc-g-tuner.rst | 19 +-
> .../media/v4l/vidioc-log-status.rst | 10 +-
> .../media/v4l/vidioc-overlay.rst | 10 +-
> .../media/v4l/vidioc-prepare-buf.rst | 10 +-
> .../userspace-api/media/v4l/vidioc-qbuf.rst | 17 +-
> .../media/v4l/vidioc-query-dv-timings.rst | 15 +-
> .../media/v4l/vidioc-querybuf.rst | 10 +-
> .../media/v4l/vidioc-querycap.rst | 16 +-
> .../media/v4l/vidioc-queryctrl.rst | 22 +-
> .../media/v4l/vidioc-querystd.rst | 15 +-
> .../media/v4l/vidioc-reqbufs.rst | 10 +-
> .../media/v4l/vidioc-s-hw-freq-seek.rst | 11 +-
> .../media/v4l/vidioc-streamon.rst | 14 +-
> .../v4l/vidioc-subdev-enum-frame-interval.rst | 10 +-
> .../v4l/vidioc-subdev-enum-frame-size.rst | 11 +-
> .../v4l/vidioc-subdev-enum-mbus-code.rst | 10 +-
> .../media/v4l/vidioc-subdev-g-crop.rst | 16 +-
> .../media/v4l/vidioc-subdev-g-fmt.rst | 17 +-
> .../v4l/vidioc-subdev-g-frame-interval.rst | 16 +-
> .../media/v4l/vidioc-subdev-g-selection.rst | 17 +-
> .../media/v4l/vidioc-subdev-querycap.rst | 9 +-
> .../media/v4l/vidioc-subscribe-event.rst | 17 +-
> .../virt/uml/user_mode_linux_howto_v2.rst | 1 +
> Documentation/vm/hmm.rst | 2 +-
> Documentation/vm/ksm.rst | 2 +-
> Documentation/vm/memory-model.rst | 6 +-
> MAINTAINERS | 16 +-
> block/bio.c | 4 +-
> drivers/base/core.c | 7 +-
> .../gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h | 2 +
> drivers/gpu/drm/drm_prime.c | 1 +
> drivers/infiniband/ulp/srpt/ib_srpt.h | 1 +
> drivers/net/appletalk/Kconfig | 2 +-
> drivers/net/hamradio/scc.c | 2 +-
> include/drm/drm_dp_helper.h | 2 +-
> include/drm/drm_edid.h | 7 -
> include/kunit/test.h | 16 +-
> include/linux/devfreq.h | 7 +-
> include/linux/input/sparse-keymap.h | 1 +
> include/linux/math64.h | 8 +-
> include/linux/refcount.h | 7 +
> include/linux/usb/typec_altmode.h | 16 +
> include/net/cfg80211.h | 1 +
> kernel/rcu/tree.c | 14 +-
> kernel/workqueue.c | 3 +
> mm/ksm.c | 2 +-
> mm/memblock.c | 8 +-
> scripts/kernel-doc | 303 +++++++++++++-----
> 316 files changed, 1921 insertions(+), 2285 deletions(-)
> delete mode 100644 Documentation/driver-api/sound.rst
>
> --
> 2.26.2
>
>
--
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch
Em Thu, 15 Oct 2020 17:49:23 +0200
Daniel Vetter <[email protected]> escreveu:
> On Tue, Oct 13, 2020 at 01:53:15PM +0200, Mauro Carvalho Chehab wrote:
> > This series actually folds the previous Sphinx 3.x patch series
> > with the other patches I sent fixing warnings with Sphinx
> > 2.x and with kernel-doc and that weren't merged yet via
> > some other tree.
> >
> > It is based on the top of upstream, plus the media
> > pull request I sent yesterday:
> >
> > https://lore.kernel.org/lkml/[email protected]/
> >
> > My plan is to send a pull request with those patches after Thursday's
> > linux next release.
> >
> > On this series, I removed the patches that depend on material
> > currently found only at linux-next.
>
> Was a bit tricky to find the cover letter here and that you plan to
> send these out this merge window.
Sorry for that. As this series touch lots of subsystems, just c/c
the maintainers mean more than 50 c/c to patch 00. Some e-mail
servers may not accept e-mails with too many c/c people.
Yet, checking at the c/c list of the original patch, you were
copied on patch 00/80. So, maybe the e-mail server had silently
dropped the original e-mail.
> I think we'll have some confusion
> now with Alex from amd having picked up a few already.
I ended moving (at least part of) the drm patches from this
series into a second one, as I'm intending to submit most of
those patches today or tomorrow, and the remaining ones by the
end of the merge window.
> Anyway Acked-by: Daniel Vetter <[email protected]> for the
> remaining drm patches.
Thank you!
> Although I can also pick them up to
> drm-misc-next (but that's going to be 5.11 or so).
It would be a way better to have them merged for 5.10, in
order to have a clean html build there.
Thanks,
Mauro