Merge tag 'docs/v5.10-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media

54a4c789 · Linus Torvalds <[email protected]> · 2020-10-16 15:02:21 -07:00

Pull documentation updates from Mauro Carvalho Chehab:
 "A series of patches addressing warnings produced by make htmldocs.
  This includes:

   - kernel-doc markup fixes

   - ReST fixes

   - Updates at the build system in order to support newer versions of
     the docs build toolchain (Sphinx)

  After this series, the number of html build warnings should reduce
  significantly, and building with Sphinx 3.1 or later should now be
  supported (although it is still recommended to use Sphinx 2.4.4).

  As agreed with Jon, I should be sending you a late pull request by the
  end of the merge window addressing remaining issues with docs build,
  as there are a number of warning fixes that depends on pull requests
  that should be happening along the merge window.

  The end goal is to have a clean htmldocs build on Kernel 5.10.

  PS. It should be noticed that Sphinx 3.0 is not currently supported,
  as it lacks support for C domain namespaces. Such feature, needed in
  order to document uAPI system calls with Sphinx 3.x, was added only on
  Sphinx 3.1"

* tag 'docs/v5.10-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media: (75 commits)
  PM / devfreq: remove a duplicated kernel-doc markup
  mm/doc: fix a literal block markup
  workqueue: fix a kernel-doc warning
  docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup
  Input: sparse-keymap: add a description for @sw
  rcu/tree: docs: document bkvcache new members at struct kfree_rcu_cpu
  nl80211: docs: add a description for s1g_cap parameter
  usb: docs: document altmode register/unregister functions
  kunit: test.h: fix a bad kernel-doc markup
  drivers: core: fix kernel-doc markup for dev_err_probe()
  docs: bio: fix a kerneldoc markup
  kunit: test.h: solve kernel-doc warnings
  block: bio: fix a warning at the kernel-doc markups
  docs: powerpc: syscall64-abi.rst: fix a malformed table
  drivers: net: hamradio: fix document location
  net: appletalk: Kconfig: Fix docs location
  dt-bindings: fix references to files converted to yaml
  memblock: get rid of a :c:type leftover
  math64.h: kernel-docs: Convert some markups into normal comments
  media: uAPI: buffer.rst: remove a left-over documentation
  ...

Commit: 54a4c789ca8091ab8fcd70285caeee2c5bc62997
Parents: 93f3d8f5 · 3e2ac979

Merge commit. Changes below are compared with the first parent: 93f3d8f5.

Changes

309 files changed · +1952 −2275

File	Status	Add	Del	Content
Documentation/admin-guide/pm/cpufreq.rst	modified	+5	−6	View file
Documentation/admin-guide/pstore-blk.rst	modified	+2	−8	View file
Documentation/block/blk-mq.rst	modified	+6	−6	View file
Documentation/block/inline-encryption.rst	modified	+4	−4	View file
Documentation/conf.py	modified	+62	−3	View file
Documentation/core-api/genericirq.rst	modified	+2	−0	View file
Documentation/core-api/kernel-api.rst	modified	+0	−6	View file
Documentation/core-api/workqueue.rst	modified	+2	−0	View file
Documentation/dev-tools/kgdb.rst	modified	+3	−3	View file
Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt	modified	+1	−1	View file
Documentation/devicetree/bindings/mailbox/omap-mailbox.txt	modified	+1	−1	View file
Documentation/devicetree/bindings/media/i2c/tvp5150.txt	modified	+1	−1	View file
Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml	modified	+1	−1	View file
Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml	modified	+1	−1	View file
Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml	modified	+1	−1	View file
Documentation/doc-guide/kernel-doc.rst	modified	+8	−0	View file
Documentation/driver-api/basics.rst	modified	+4	−15	View file
Documentation/driver-api/device_link.rst	modified	+4	−9	View file
Documentation/driver-api/fpga/fpga-bridge.rst	modified	+2	−2	View file
Documentation/driver-api/fpga/fpga-mgr.rst	modified	+3	−3	View file
Documentation/driver-api/fpga/fpga-programming.rst	modified	+1	−1	View file
Documentation/driver-api/fpga/fpga-region.rst	modified	+3	−3	View file
Documentation/driver-api/iio/buffers.rst	modified	+1	−1	View file
Documentation/driver-api/iio/core.rst	modified	+3	−3	View file
Documentation/driver-api/iio/hw-consumer.rst	modified	+1	−1	View file
Documentation/driver-api/iio/triggered-buffers.rst	modified	+1	−1	View file
Documentation/driver-api/iio/triggers.rst	modified	+2	−2	View file
Documentation/driver-api/index.rst	modified	+0	−1	View file
Documentation/driver-api/infrastructure.rst	modified	+1	−3	View file
Documentation/driver-api/libata.rst	modified	+1	−1	View file
Documentation/driver-api/media/cec-core.rst	modified	+1	−1	View file
Documentation/driver-api/media/dtv-frontend.rst	modified	+2	−2	View file
Documentation/driver-api/media/mc-core.rst	modified	+12	−12	View file
Documentation/driver-api/media/v4l2-controls.rst	modified	+1	−1	View file
Documentation/driver-api/media/v4l2-dev.rst	modified	+4	−4	View file
Documentation/driver-api/media/v4l2-device.rst	modified	+3	−3	View file
Documentation/driver-api/media/v4l2-event.rst	modified	+5	−5	View file
Documentation/driver-api/media/v4l2-fh.rst	modified	+8	−8	View file
Documentation/driver-api/media/v4l2-subdev.rst	modified	+1	−1	View file
Documentation/driver-api/mei/mei.rst	modified	+1	−1	View file
Documentation/driver-api/pm/cpuidle.rst	modified	+30	−35	View file
Documentation/driver-api/pm/devices.rst	modified	+9	−17	View file
Documentation/driver-api/regulator.rst	modified	+2	−2	View file
Documentation/driver-api/sound.rst	deleted	+0	−54	View before deletion
Documentation/driver-api/target.rst	modified	+0	−12	View file
Documentation/driver-api/usb/URB.rst	modified	+1	−1	View file
Documentation/driver-api/usb/gadget.rst	modified	+5	−5	View file
Documentation/driver-api/usb/hotplug.rst	modified	+1	−1	View file
Documentation/driver-api/usb/typec_bus.rst	modified	+7	−1	View file
Documentation/filesystems/fscrypt.rst	modified	+36	−38	View file
Documentation/filesystems/fsverity.rst	modified	+1	−1	View file
Documentation/gpu/i915.rst	modified	+25	−4	View file
Documentation/networking/ieee802154.rst	modified	+10	−8	View file
Documentation/powerpc/syscall64-abi.rst	modified	+16	−16	View file
Documentation/sound/designs/tracepoints.rst	modified	+11	−11	View file
Documentation/sound/kernel-api/alsa-driver-api.rst	modified	+1	−0	View file
Documentation/sound/kernel-api/writing-an-alsa-driver.rst	modified	+49	−61	View file
Documentation/sphinx/automarkup.py	modified	+97	−11	View file
Documentation/sphinx/cdomain.py	modified	+92	−1	View file
Documentation/sphinx/kerneldoc.py	modified	+14	−1	View file
Documentation/sphinx/parse-headers.pl	modified	+1	−1	View file
Documentation/trace/ftrace-uses.rst	modified	+6	−6	View file
Documentation/translations/it_IT/kernel-hacking/hacking.rst	modified	+1	−1	View file
Documentation/translations/it_IT/kernel-hacking/locking.rst	modified	+2	−0	View file
Documentation/translations/zh_CN/arm64/amu.rst	modified	+2	−2	View file
Documentation/userspace-api/media/cec/cec-func-close.rst	modified	+3	−7	View file
Documentation/userspace-api/media/cec/cec-func-ioctl.rst	modified	+4	−7	View file
Documentation/userspace-api/media/cec/cec-func-open.rst	modified	+3	−7	View file
Documentation/userspace-api/media/cec/cec-func-poll.rst	modified	+5	−9	View file
Documentation/userspace-api/media/cec/cec-ioc-adap-g-caps.rst	modified	+5	−5	View file
Documentation/userspace-api/media/cec/cec-ioc-adap-g-conn-info.rst	modified	+6	−5	View file
Documentation/userspace-api/media/cec/cec-ioc-adap-g-log-addrs.rst	modified	+8	−12	View file
Documentation/userspace-api/media/cec/cec-ioc-adap-g-phys-addr.rst	modified	+8	−7	View file
Documentation/userspace-api/media/cec/cec-ioc-dqevent.rst	modified	+5	−10	View file
Documentation/userspace-api/media/cec/cec-ioc-g-mode.rst	modified	+8	−8	View file
Documentation/userspace-api/media/cec/cec-ioc-receive.rst	modified	+8	−10	View file
Documentation/userspace-api/media/dvb/audio-bilingual-channel-select.rst	modified	+3	−4	View file
Documentation/userspace-api/media/dvb/audio-channel-select.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-clear-buffer.rst	modified	+4	−4	View file
Documentation/userspace-api/media/dvb/audio-continue.rst	modified	+3	−4	View file
Documentation/userspace-api/media/dvb/audio-fclose.rst	modified	+1	−6	View file
Documentation/userspace-api/media/dvb/audio-fopen.rst	modified	+1	−6	View file
Documentation/userspace-api/media/dvb/audio-fwrite.rst	modified	+1	−6	View file
Documentation/userspace-api/media/dvb/audio-get-capabilities.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-get-status.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-pause.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/audio-play.rst	modified	+3	−4	View file
Documentation/userspace-api/media/dvb/audio-select-source.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-set-av-sync.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-set-bypass-mode.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/audio-set-id.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/audio-set-mixer.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/audio-set-mute.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/audio-set-streamtype.rst	modified	+3	−7	View file
Documentation/userspace-api/media/dvb/audio-stop.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/ca-fclose.rst	modified	+2	−5	View file
Documentation/userspace-api/media/dvb/ca-fopen.rst	modified	+1	−6	View file
Documentation/userspace-api/media/dvb/ca-get-cap.rst	modified	+4	−4	View file
Documentation/userspace-api/media/dvb/ca-get-descr-info.rst	modified	+5	−4	View file
Documentation/userspace-api/media/dvb/ca-get-msg.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/ca-get-slot-info.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/ca-reset.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/ca-send-msg.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/ca-set-descr.rst	modified	+4	−4	View file
Documentation/userspace-api/media/dvb/dmx-add-pid.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/dmx-expbuf.rst	modified	+4	−7	View file
Documentation/userspace-api/media/dvb/dmx-fclose.rst	modified	+3	−6	View file
Documentation/userspace-api/media/dvb/dmx-fopen.rst	modified	+1	−4	View file
Documentation/userspace-api/media/dvb/dmx-fread.rst	modified	+2	−5	View file
Documentation/userspace-api/media/dvb/dmx-fwrite.rst	modified	+2	−4	View file
Documentation/userspace-api/media/dvb/dmx-get-pes-pids.rst	modified	+5	−7	View file
Documentation/userspace-api/media/dvb/dmx-get-stc.rst	modified	+5	−7	View file
Documentation/userspace-api/media/dvb/dmx-mmap.rst	modified	+6	−9	View file
Documentation/userspace-api/media/dvb/dmx-munmap.rst	modified	+5	−9	View file
Documentation/userspace-api/media/dvb/dmx-qbuf.rst	modified	+8	−9	View file
Documentation/userspace-api/media/dvb/dmx-querybuf.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/dmx-remove-pid.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/dmx-reqbufs.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/dmx-set-buffer-size.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/dmx-set-filter.rst	modified	+5	−7	View file
Documentation/userspace-api/media/dvb/dmx-set-pes-filter.rst	modified	+4	−9	View file
Documentation/userspace-api/media/dvb/dmx-start.rst	modified	+4	−7	View file
Documentation/userspace-api/media/dvb/dmx-stop.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-diseqc-recv-slave-reply.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-diseqc-reset-overload.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-diseqc-send-burst.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/fe-diseqc-send-master-cmd.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-dishnetwork-send-legacy-cmd.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/fe-enable-high-lnb-voltage.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/fe-get-event.rst	modified	+4	−8	View file
Documentation/userspace-api/media/dvb/fe-get-frontend.rst	modified	+4	−8	View file
Documentation/userspace-api/media/dvb/fe-get-info.rst	modified	+4	−7	View file
Documentation/userspace-api/media/dvb/fe-get-property.rst	modified	+7	−8	View file
Documentation/userspace-api/media/dvb/fe-read-ber.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-read-signal-strength.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-read-snr.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-read-status.rst	modified	+4	−7	View file
Documentation/userspace-api/media/dvb/fe-read-uncorrected-blocks.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/fe-set-frontend-tune-mode.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/fe-set-frontend.rst	modified	+4	−7	View file
Documentation/userspace-api/media/dvb/fe-set-tone.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/fe-set-voltage.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/frontend_f_close.rst	modified	+2	−6	View file
Documentation/userspace-api/media/dvb/frontend_f_open.rst	modified	+2	−8	View file
Documentation/userspace-api/media/dvb/net-add-if.rst	modified	+4	−5	View file
Documentation/userspace-api/media/dvb/net-get-if.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/net-remove-if.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/video-clear-buffer.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-command.rst	modified	+4	−6	View file
Documentation/userspace-api/media/dvb/video-continue.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-fast-forward.rst	modified	+3	−7	View file
Documentation/userspace-api/media/dvb/video-fclose.rst	modified	+1	−5	View file
Documentation/userspace-api/media/dvb/video-fopen.rst	modified	+1	−5	View file
Documentation/userspace-api/media/dvb/video-freeze.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-fwrite.rst	modified	+1	−5	View file
Documentation/userspace-api/media/dvb/video-get-capabilities.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-get-event.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-get-frame-count.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-get-pts.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-get-size.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-get-status.rst	modified	+3	−4	View file
Documentation/userspace-api/media/dvb/video-play.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-select-source.rst	modified	+3	−4	View file
Documentation/userspace-api/media/dvb/video-set-blank.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-set-display-format.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-set-format.rst	modified	+3	−6	View file
Documentation/userspace-api/media/dvb/video-set-streamtype.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-slowmotion.rst	modified	+3	−7	View file
Documentation/userspace-api/media/dvb/video-stillpicture.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-stop.rst	modified	+3	−5	View file
Documentation/userspace-api/media/dvb/video-try-command.rst	modified	+3	−5	View file
Documentation/userspace-api/media/mediactl/media-func-close.rst	modified	+3	−7	View file
Documentation/userspace-api/media/mediactl/media-func-ioctl.rst	modified	+3	−7	View file
Documentation/userspace-api/media/mediactl/media-func-open.rst	modified	+3	−7	View file
Documentation/userspace-api/media/mediactl/media-ioc-device-info.rst	modified	+4	−9	View file
Documentation/userspace-api/media/mediactl/media-ioc-enum-entities.rst	modified	+4	−7	View file
Documentation/userspace-api/media/mediactl/media-ioc-enum-links.rst	modified	+4	−9	View file
Documentation/userspace-api/media/mediactl/media-ioc-g-topology.rst	modified	+4	−10	View file
Documentation/userspace-api/media/mediactl/media-ioc-request-alloc.rst	modified	+5	−6	View file
Documentation/userspace-api/media/mediactl/media-ioc-setup-link.rst	modified	+4	−6	View file
Documentation/userspace-api/media/mediactl/media-request-ioc-queue.rst	modified	+3	−4	View file
Documentation/userspace-api/media/mediactl/media-request-ioc-reinit.rst	modified	+4	−4	View file
Documentation/userspace-api/media/mediactl/request-api.rst	modified	+3	−2	View file
Documentation/userspace-api/media/mediactl/request-func-close.rst	modified	+2	−6	View file
Documentation/userspace-api/media/mediactl/request-func-ioctl.rst	modified	+2	−6	View file
Documentation/userspace-api/media/mediactl/request-func-poll.rst	modified	+4	−8	View file
Documentation/userspace-api/media/rc/lirc-get-features.rst	modified	+4	−5	View file
Documentation/userspace-api/media/rc/lirc-get-rec-mode.rst	modified	+7	−5	View file
Documentation/userspace-api/media/rc/lirc-get-rec-resolution.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-get-send-mode.rst	modified	+7	−7	View file
Documentation/userspace-api/media/rc/lirc-get-timeout.rst	modified	+7	−6	View file
Documentation/userspace-api/media/rc/lirc-read.rst	modified	+3	−7	View file
Documentation/userspace-api/media/rc/lirc-set-measure-carrier-mode.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-rec-carrier-range.rst	modified	+4	−2	View file
Documentation/userspace-api/media/rc/lirc-set-rec-carrier.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-rec-timeout-reports.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-rec-timeout.rst	modified	+7	−6	View file
Documentation/userspace-api/media/rc/lirc-set-send-carrier.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-send-duty-cycle.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-transmitter-mask.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-set-wideband-receiver.rst	modified	+4	−4	View file
Documentation/userspace-api/media/rc/lirc-write.rst	modified	+2	−5	View file
Documentation/userspace-api/media/v4l/buffer.rst	modified	+3	−25	View file
Documentation/userspace-api/media/v4l/dev-capture.rst	modified	+2	−5	View file
Documentation/userspace-api/media/v4l/dev-output.rst	modified	+2	−5	View file
Documentation/userspace-api/media/v4l/dev-raw-vbi.rst	modified	+6	−13	View file
Documentation/userspace-api/media/v4l/dev-rds.rst	modified	+3	−9	View file
Documentation/userspace-api/media/v4l/dev-sliced-vbi.rst	modified	+7	−24	View file
Documentation/userspace-api/media/v4l/diff-v4l.rst	modified	+6	−33	View file
Documentation/userspace-api/media/v4l/dmabuf.rst	modified	+4	−4	View file
Documentation/userspace-api/media/v4l/format.rst	modified	+3	−4	View file
Documentation/userspace-api/media/v4l/func-close.rst	modified	+2	−6	View file
Documentation/userspace-api/media/v4l/func-ioctl.rst	modified	+3	−7	View file
Documentation/userspace-api/media/v4l/func-mmap.rst	modified	+7	−11	View file
Documentation/userspace-api/media/v4l/func-munmap.rst	modified	+5	−9	View file
Documentation/userspace-api/media/v4l/func-open.rst	modified	+5	−9	View file
Documentation/userspace-api/media/v4l/func-poll.rst	modified	+18	−22	View file
Documentation/userspace-api/media/v4l/func-read.rst	modified	+18	−21	View file
Documentation/userspace-api/media/v4l/func-select.rst	modified	+19	−23	View file
Documentation/userspace-api/media/v4l/func-write.rst	modified	+5	−8	View file
Documentation/userspace-api/media/v4l/hist-v4l2.rst	modified	+4	−66	View file
Documentation/userspace-api/media/v4l/io.rst	modified	+3	−3	View file
Documentation/userspace-api/media/v4l/libv4l-introduction.rst	modified	+13	−17	View file
Documentation/userspace-api/media/v4l/mmap.rst	modified	+13	−13	View file
Documentation/userspace-api/media/v4l/open.rst	modified	+6	−9	View file
Documentation/userspace-api/media/v4l/rw.rst	modified	+9	−9	View file
Documentation/userspace-api/media/v4l/streaming-par.rst	modified	+3	−2	View file
Documentation/userspace-api/media/v4l/userp.rst	modified	+6	−5	View file
Documentation/userspace-api/media/v4l/vidioc-create-bufs.rst	modified	+4	−7	View file
Documentation/userspace-api/media/v4l/vidioc-cropcap.rst	modified	+4	−7	View file
Documentation/userspace-api/media/v4l/vidioc-dbg-g-chip-info.rst	modified	+4	−9	View file
Documentation/userspace-api/media/v4l/vidioc-dbg-g-register.rst	modified	+7	−11	View file
Documentation/userspace-api/media/v4l/vidioc-decoder-cmd.rst	modified	+8	−11	View file
Documentation/userspace-api/media/v4l/vidioc-dqevent.rst	modified	+4	−15	View file
Documentation/userspace-api/media/v4l/vidioc-dv-timings-cap.rst	modified	+7	−10	View file
Documentation/userspace-api/media/v4l/vidioc-encoder-cmd.rst	modified	+11	−14	View file
Documentation/userspace-api/media/v4l/vidioc-enum-dv-timings.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-enum-fmt.rst	modified	+4	−8	View file
Documentation/userspace-api/media/v4l/vidioc-enum-frameintervals.rst	modified	+4	−11	View file
Documentation/userspace-api/media/v4l/vidioc-enum-framesizes.rst	modified	+4	−12	View file
Documentation/userspace-api/media/v4l/vidioc-enum-freq-bands.rst	modified	+4	−8	View file
Documentation/userspace-api/media/v4l/vidioc-enumaudio.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-enumaudioout.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-enuminput.rst	modified	+4	−10	View file
Documentation/userspace-api/media/v4l/vidioc-enumoutput.rst	modified	+4	−9	View file
Documentation/userspace-api/media/v4l/vidioc-enumstd.rst	modified	+7	−16	View file
Documentation/userspace-api/media/v4l/vidioc-expbuf.rst	modified	+4	−10	View file
Documentation/userspace-api/media/v4l/vidioc-g-audio.rst	modified	+7	−11	View file
Documentation/userspace-api/media/v4l/vidioc-g-audioout.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-crop.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-ctrl.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst	modified	+13	−13	View file
Documentation/userspace-api/media/v4l/vidioc-g-edid.rst	modified	+12	−13	View file
Documentation/userspace-api/media/v4l/vidioc-g-enc-index.rst	modified	+4	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-ext-ctrls.rst	modified	+8	−13	View file
Documentation/userspace-api/media/v4l/vidioc-g-fbuf.rst	modified	+7	−11	View file
Documentation/userspace-api/media/v4l/vidioc-g-fmt.rst	modified	+11	−11	View file
Documentation/userspace-api/media/v4l/vidioc-g-frequency.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-input.rst	modified	+7	−8	View file
Documentation/userspace-api/media/v4l/vidioc-g-jpegcomp.rst	modified	+7	−10	View file
Documentation/userspace-api/media/v4l/vidioc-g-modulator.rst	modified	+7	−10	View file
Documentation/userspace-api/media/v4l/vidioc-g-output.rst	modified	+7	−8	View file
Documentation/userspace-api/media/v4l/vidioc-g-parm.rst	modified	+12	−18	View file
Documentation/userspace-api/media/v4l/vidioc-g-priority.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-selection.rst	modified	+6	−9	View file
Documentation/userspace-api/media/v4l/vidioc-g-sliced-vbi-cap.rst	modified	+4	−8	View file
Documentation/userspace-api/media/v4l/vidioc-g-std.rst	modified	+13	−11	View file
Documentation/userspace-api/media/v4l/vidioc-g-tuner.rst	modified	+7	−12	View file
Documentation/userspace-api/media/v4l/vidioc-log-status.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-overlay.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-prepare-buf.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-qbuf.rst	modified	+8	−9	View file
Documentation/userspace-api/media/v4l/vidioc-query-dv-timings.rst	modified	+7	−8	View file
Documentation/userspace-api/media/v4l/vidioc-querybuf.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-querycap.rst	modified	+6	−10	View file
Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst	modified	+8	−14	View file
Documentation/userspace-api/media/v4l/vidioc-querystd.rst	modified	+7	−8	View file
Documentation/userspace-api/media/v4l/vidioc-reqbufs.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-s-hw-freq-seek.rst	modified	+4	−7	View file
Documentation/userspace-api/media/v4l/vidioc-streamon.rst	modified	+7	−7	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-enum-frame-interval.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-enum-frame-size.rst	modified	+4	−7	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-enum-mbus-code.rst	modified	+4	−6	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-g-crop.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-g-fmt.rst	modified	+7	−10	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-g-frame-interval.rst	modified	+7	−9	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-g-selection.rst	modified	+7	−10	View file
Documentation/userspace-api/media/v4l/vidioc-subdev-querycap.rst	modified	+4	−5	View file
Documentation/userspace-api/media/v4l/vidioc-subscribe-event.rst	modified	+7	−10	View file
Documentation/virt/uml/user_mode_linux_howto_v2.rst	modified	+1	−0	View file
Documentation/vm/hmm.rst	modified	+1	−1	View file
Documentation/vm/ksm.rst	modified	+1	−1	View file
Documentation/vm/memory-model.rst	modified	+3	−3	View file
MAINTAINERS	modified	+8	−8	View file
block/bio.c	modified	+2	−2	View file
drivers/base/core.c	modified	+5	−2	View file
drivers/net/appletalk/Kconfig	modified	+1	−1	View file
drivers/net/hamradio/scc.c	modified	+1	−1	View file
include/kunit/test.h	modified	+9	−5	View file
include/linux/devfreq.h	modified	+1	−6	View file
include/linux/input/sparse-keymap.h	modified	+1	−0	View file
include/linux/math64.h	modified	+4	−4	View file
include/linux/usb/typec_altmode.h	modified	+16	−0	View file
include/net/cfg80211.h	modified	+1	−0	View file
kernel/rcu/tree.c	modified	+6	−8	View file
kernel/workqueue.c	modified	+3	−0	View file
mm/ksm.c	modified	+1	−1	View file
mm/memblock.c	modified	+4	−4	View file
scripts/kernel-doc	modified	+223	−82	View file

Only the first 600 diff lines are shown. Download the complete patch.

Documentation/admin-guide/pm/cpufreq.rst

View file

diff --git a/Documentation/admin-guide/pm/cpufreq.rst b/Documentation/admin-guide/pm/cpufreq.rst
index 368e612..6adb798 100644
--- a/Documentation/admin-guide/pm/cpufreq.rst
+++ b/Documentation/admin-guide/pm/cpufreq.rst
@@ -1,7 +1,6 @@
 .. SPDX-License-Identifier: GPL-2.0
 .. include:: <isonum.txt>
 
-.. |struct cpufreq_policy| replace:: :c:type:`struct cpufreq_policy <cpufreq_policy>`
 .. |intel_pstate| replace:: :doc:`intel_pstate <intel_pstate>`
 
 =======================
@@ -92,16 +91,16 @@ control the P-state of multiple CPUs at the same time and writing to it affects
 all of those CPUs simultaneously.
 
 Sets of CPUs sharing hardware P-state control interfaces are represented by
-``CPUFreq`` as |struct cpufreq_policy| objects.  For consistency,
-|struct cpufreq_policy| is also used when there is only one CPU in the given
+``CPUFreq`` as struct cpufreq_policy objects.  For consistency,
+struct cpufreq_policy is also used when there is only one CPU in the given
 set.
 
-The ``CPUFreq`` core maintains a pointer to a |struct cpufreq_policy| object for
+The ``CPUFreq`` core maintains a pointer to a struct cpufreq_policy object for
 every CPU in the system, including CPUs that are currently offline.  If multiple
 CPUs share the same hardware P-state control interface, all of the pointers
-corresponding to them point to the same |struct cpufreq_policy| object.
+corresponding to them point to the same struct cpufreq_policy object.
 
-``CPUFreq`` uses |struct cpufreq_policy| as its basic data type and the design
+``CPUFreq`` uses struct cpufreq_policy as its basic data type and the design
 of its user space interface is based on the policy concept.
 
 

Documentation/admin-guide/pstore-blk.rst

View file

diff --git a/Documentation/admin-guide/pstore-blk.rst b/Documentation/admin-guide/pstore-blk.rst
index 296d502..6898aba 100644
--- a/Documentation/admin-guide/pstore-blk.rst
+++ b/Documentation/admin-guide/pstore-blk.rst
@@ -154,17 +154,11 @@ Configurations for driver
 Only a block device driver cares about these configurations. A block device
 driver uses ``register_pstore_blk`` to register to pstore/blk.
 
-.. kernel-doc:: fs/pstore/blk.c
-   :identifiers: register_pstore_blk
-
 A non-block device driver uses ``register_pstore_device`` with
 ``struct pstore_device_info`` to register to pstore/blk.
 
 .. kernel-doc:: fs/pstore/blk.c
-   :identifiers: register_pstore_device
-
-.. kernel-doc:: include/linux/pstore_blk.h
-   :identifiers: pstore_device_info
+   :export:
 
 Compression and header
 ----------------------
@@ -237,7 +231,7 @@ For developer reference, here are all the important structures and APIs:
    :internal:
 
 .. kernel-doc:: fs/pstore/blk.c
-   :export:
+   :internal:
 
 .. kernel-doc:: include/linux/pstore_blk.h
    :internal:

Documentation/block/blk-mq.rst

View file

diff --git a/Documentation/block/blk-mq.rst b/Documentation/block/blk-mq.rst
index 88c56af..a980d23 100644
--- a/Documentation/block/blk-mq.rst
+++ b/Documentation/block/blk-mq.rst
@@ -63,10 +63,10 @@ Software staging queues
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 The block IO subsystem adds requests  in the software staging queues
-(represented by struct :c:type:`blk_mq_ctx`) in case that they weren't sent
+(represented by struct blk_mq_ctx) in case that they weren't sent
 directly to the driver. A request is one or more BIOs. They arrived at the
-block layer through the data structure struct :c:type:`bio`. The block layer
-will then build a new structure from it, the struct :c:type:`request` that will
+block layer through the data structure struct bio. The block layer
+will then build a new structure from it, the struct request that will
 be used to communicate with the device driver. Each queue has its own lock and
 the number of queues is defined by a per-CPU or per-node basis.
 
@@ -102,7 +102,7 @@ hardware queue will be drained in sequence according to their mapping.
 Hardware dispatch queues
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-The hardware queue (represented by struct :c:type:`blk_mq_hw_ctx`) is a struct
+The hardware queue (represented by struct blk_mq_hw_ctx) is a struct
 used by device drivers to map the device submission queues (or device DMA ring
 buffer), and are the last step of the block layer submission code before the
 low level device driver taking ownership of the request. To run this queue, the
@@ -110,9 +110,9 @@ block layer removes requests from the associated software queues and tries to
 dispatch to the hardware.
 
 If it's not possible to send the requests directly to hardware, they will be
-added to a linked list (:c:type:`hctx->dispatch`) of requests. Then,
+added to a linked list (``hctx->dispatch``) of requests. Then,
 next time the block layer runs a queue, it will send the requests laying at the
-:c:type:`dispatch` list first, to ensure a fairness dispatch with those
+``dispatch`` list first, to ensure a fairness dispatch with those
 requests that were ready to be sent first. The number of hardware queues
 depends on the number of hardware contexts supported by the hardware and its
 device driver, but it will not be more than the number of cores of the system.

Documentation/block/inline-encryption.rst

View file

diff --git a/Documentation/block/inline-encryption.rst b/Documentation/block/inline-encryption.rst
index 354817b..e75151e 100644
--- a/Documentation/block/inline-encryption.rst
+++ b/Documentation/block/inline-encryption.rst
@@ -52,7 +52,7 @@ Constraints and notes
 Design
 ======
 
-We add a :c:type:`struct bio_crypt_ctx` to :c:type:`struct bio` that can
+We add a struct bio_crypt_ctx to struct bio that can
 represent an encryption context, because we need to be able to pass this
 encryption context from the upper layers (like the fs layer) to the
 device driver to act upon.
@@ -85,7 +85,7 @@ blk-mq changes, other block layer changes and blk-crypto-fallback
 =================================================================
 
 We add a pointer to a ``bi_crypt_context`` and ``keyslot`` to
-:c:type:`struct request`. These will be referred to as the ``crypto fields``
+struct request. These will be referred to as the ``crypto fields``
 for the request. This ``keyslot`` is the keyslot into which the
 ``bi_crypt_context`` has been programmed in the KSM of the ``request_queue``
 that this request is being sent to.
@@ -118,7 +118,7 @@ of the algorithm being used adheres to spec and functions correctly).
 If a ``request queue``'s inline encryption hardware claimed to support the
 encryption context specified with a bio, then it will not be handled by the
 ``blk-crypto-fallback``. We will eventually reach a point in blk-mq when a
-:c:type:`struct request` needs to be allocated for that bio. At that point,
+struct request needs to be allocated for that bio. At that point,
 blk-mq tries to program the encryption context into the ``request_queue``'s
 keyslot_manager, and obtain a keyslot, which it stores in its newly added
 ``keyslot`` field. This keyslot is released when the request is completed.
@@ -188,7 +188,7 @@ keyslots supported by the hardware.
 The device driver also needs to tell the KSM how to actually manipulate the
 IE hardware in the device to do things like programming the crypto key into
 the IE hardware into a particular keyslot. All this is achieved through the
-:c:type:`struct blk_ksm_ll_ops` field in the KSM that the device driver
+struct blk_ksm_ll_ops field in the KSM that the device driver
 must fill up after initing the ``blk_keyslot_manager``.
 
 The KSM also handles runtime power management for the device when applicable

Documentation/conf.py

View file

diff --git a/Documentation/conf.py b/Documentation/conf.py
index 0a102d5..376dd0d 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -47,9 +47,68 @@ extensions = ['kerneldoc', 'rstFlatTable', 'kernel_include',
 #
 if major >= 3:
     sys.stderr.write('''WARNING: The kernel documentation build process
-	does not work correctly with Sphinx v3.0 and above.  Expect errors
-	in the generated output.
-	''')
+        support for Sphinx v3.0 and above is brand new. Be prepared for
+        possible issues in the generated output.
+        ''')
+    if minor > 0 or patch >= 2:
+        # Sphinx c function parser is more pedantic with regards to type
+        # checking. Due to that, having macros at c:function cause problems.
+        # Those needed to be scaped by using c_id_attributes[] array
+        c_id_attributes = [
+            # GCC Compiler types not parsed by Sphinx:
+            "__restrict__",
+
+            # include/linux/compiler_types.h:
+            "__iomem",
+            "__kernel",
+            "noinstr",
+            "notrace",
+            "__percpu",
+            "__rcu",
+            "__user",
+
+            # include/linux/compiler_attributes.h:
+            "__alias",
+            "__aligned",
+            "__aligned_largest",
+            "__always_inline",
+            "__assume_aligned",
+            "__cold",
+            "__attribute_const__",
+            "__copy",
+            "__pure",
+            "__designated_init",
+            "__visible",
+            "__printf",
+            "__scanf",
+            "__gnu_inline",
+            "__malloc",
+            "__mode",
+            "__no_caller_saved_registers",
+            "__noclone",
+            "__nonstring",
+            "__noreturn",
+            "__packed",
+            "__pure",
+            "__section",
+            "__always_unused",
+            "__maybe_unused",
+            "__used",
+            "__weak",
+            "noinline",
+
+            # include/linux/memblock.h:
+            "__init_memblock",
+            "__meminit",
+
+            # include/linux/init.h:
+            "__init",
+            "__ref",
+
+            # include/linux/linkage.h:
+            "asmlinkage",
+        ]
+
 else:
     extensions.append('cdomain')
 

Documentation/core-api/genericirq.rst

View file

diff --git a/Documentation/core-api/genericirq.rst b/Documentation/core-api/genericirq.rst
index 8f06d88..f959c9b 100644
--- a/Documentation/core-api/genericirq.rst
+++ b/Documentation/core-api/genericirq.rst
@@ -419,6 +419,7 @@ functions which are exported.
 .. kernel-doc:: kernel/irq/manage.c
 
 .. kernel-doc:: kernel/irq/chip.c
+   :export:
 
 Internal Functions Provided
 ===========================
@@ -431,6 +432,7 @@ functions.
 .. kernel-doc:: kernel/irq/handle.c
 
 .. kernel-doc:: kernel/irq/chip.c
+   :internal:
 
 Credits
 =======

Documentation/core-api/kernel-api.rst

View file

diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api/kernel-api.rst
index 4ac53a1..741aa37 100644
--- a/Documentation/core-api/kernel-api.rst
+++ b/Documentation/core-api/kernel-api.rst
@@ -231,12 +231,6 @@ Refer to the file kernel/module.c for more information.
 Hardware Interfaces
 ===================
 
-Interrupt Handling
-------------------
-
-.. kernel-doc:: kernel/irq/manage.c
-   :export:
-
 DMA Channels
 ------------
 

Documentation/core-api/workqueue.rst

View file

diff --git a/Documentation/core-api/workqueue.rst b/Documentation/core-api/workqueue.rst
index 00a5ba5..541d31d 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

Documentation/dev-tools/kgdb.rst

View file

diff --git a/Documentation/dev-tools/kgdb.rst b/Documentation/dev-tools/kgdb.rst
index c908ef4..77b688e 100644
--- a/Documentation/dev-tools/kgdb.rst
+++ b/Documentation/dev-tools/kgdb.rst
@@ -726,7 +726,7 @@ The kernel debugger is organized into a number of components:
    -  contains an arch-specific trap catcher which invokes
       kgdb_handle_exception() to start kgdb about doing its work
 
-   -  translation to and from gdb specific packet format to :c:type:`pt_regs`
+   -  translation to and from gdb specific packet format to struct pt_regs
 
    -  Registration and unregistration of architecture specific trap
       hooks
@@ -846,7 +846,7 @@ invokes a callback in the serial core which in turn uses the callback in
 the UART driver.
 
 When using kgdboc with a UART, the UART driver must implement two
-callbacks in the :c:type:`struct uart_ops <uart_ops>`.
+callbacks in the struct uart_ops.
 Example from ``drivers/8250.c``::
 
 
@@ -875,7 +875,7 @@ kernel when ``CONFIG_KDB_KEYBOARD=y`` is set in the kernel configuration.
 The core polled keyboard driver for PS/2 type keyboards is in
 ``drivers/char/kdb_keyboard.c``. This driver is hooked into the debug core
 when kgdboc populates the callback in the array called
-:c:type:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level
+:c:expr:`kdb_poll_funcs[]`. The kdb_get_kbd_char() is the top-level
 function which polls hardware for single character input.
 
 kgdboc and kms

Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt

View file

diff --git a/Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt b/Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt
index 8b2a713..3e64075 100644
--- a/Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt
+++ b/Documentation/devicetree/bindings/display/tilcdc/tilcdc.txt
@@ -37,7 +37,7 @@ Optional nodes:
    supports a single port with a single endpoint.
 
  - See also Documentation/devicetree/bindings/display/tilcdc/panel.txt and
-   Documentation/devicetree/bindings/display/bridge/ti,tfp410.txt for connecting
+   Documentation/devicetree/bindings/display/bridge/ti,tfp410.yaml for connecting
    tfp410 DVI encoder or lcd panel to lcdc
 
 [1] There is an errata about AM335x color wiring. For 16-bit color mode

Documentation/devicetree/bindings/mailbox/omap-mailbox.txt

View file

diff --git a/Documentation/devicetree/bindings/mailbox/omap-mailbox.txt b/Documentation/devicetree/bindings/mailbox/omap-mailbox.txt
index 35c3f56..5fe80c1 100644
--- a/Documentation/devicetree/bindings/mailbox/omap-mailbox.txt
+++ b/Documentation/devicetree/bindings/mailbox/omap-mailbox.txt
@@ -69,7 +69,7 @@ The following are mandatory properties for the K3 AM65x and J721E SoCs only:
 			the interrupt routes between the IP and the main GIC
 			controllers. See the following binding for additional
 			details,
-			Documentation/devicetree/bindings/interrupt-controller/ti,sci-intr.txt
+			Documentation/devicetree/bindings/interrupt-controller/ti,sci-intr.yaml
 
 Child Nodes:
 ============

Documentation/devicetree/bindings/media/i2c/tvp5150.txt

View file

diff --git a/Documentation/devicetree/bindings/media/i2c/tvp5150.txt b/Documentation/devicetree/bindings/media/i2c/tvp5150.txt
index 6c88ce8..719b299 100644
--- a/Documentation/devicetree/bindings/media/i2c/tvp5150.txt
+++ b/Documentation/devicetree/bindings/media/i2c/tvp5150.txt
@@ -56,7 +56,7 @@ Optional Connector Properties:
                   instead of using the autodetection mechnism. Please look at
                   [1] for more information.
 
-[1] Documentation/devicetree/bindings/display/connector/analog-tv-connector.txt.
+[1] Documentation/devicetree/bindings/display/connector/analog-tv-connector.yaml.
 
 Example - three input sources:
 #include <dt-bindings/display/sdtv-standards.h>

Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml

View file

diff --git a/Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml b/Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml
index 41ece1d..4cfbffd 100644
--- a/Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml
+++ b/Documentation/devicetree/bindings/pwm/google,cros-ec-pwm.yaml
@@ -14,7 +14,7 @@ description: |
   Google's ChromeOS EC PWM is a simple PWM attached to the Embedded Controller
   (EC) and controlled via a host-command interface.
   An EC PWM node should be only found as a sub-node of the EC node (see
-  Documentation/devicetree/bindings/mfd/cros-ec.txt).
+  Documentation/devicetree/bindings/mfd/google,cros-ec.yaml).
 
 properties:
   compatible:

Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml

View file

diff --git a/Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml b/Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml
index 468d658..2684f22 100644
--- a/Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml
+++ b/Documentation/devicetree/bindings/soc/qcom/qcom,smd-rpm.yaml
@@ -20,7 +20,7 @@ description: |
   present and this subnode may contain children that designate regulator
   resources.
 
-  Refer to Documentation/devicetree/bindings/regulator/qcom,smd-rpm-regulator.txt
+  Refer to Documentation/devicetree/bindings/regulator/qcom,smd-rpm-regulator.yaml
   for information on the regulator subnodes that can exist under the
   rpm_requests.
 

Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml

View file

diff --git a/Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml b/Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml
index c84e656..3b9143a 100644
--- a/Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml
+++ b/Documentation/devicetree/bindings/sound/google,cros-ec-codec.yaml
@@ -13,7 +13,7 @@ description: |
   Google's ChromeOS EC codec is a digital mic codec provided by the
   Embedded Controller (EC) and is controlled via a host-command interface.
   An EC codec node should only be found as a sub-node of the EC node (see
-  Documentation/devicetree/bindings/mfd/cros-ec.txt).
+  Documentation/devicetree/bindings/mfd/google,cros-ec.yaml).
 
 properties:
   compatible:

Documentation/doc-guide/kernel-doc.rst

View file

diff --git a/Documentation/doc-guide/kernel-doc.rst b/Documentation/doc-guide/kernel-doc.rst
index 4fd86c2..52a87ab 100644
--- a/Documentation/doc-guide/kernel-doc.rst
+++ b/Documentation/doc-guide/kernel-doc.rst
@@ -490,6 +490,14 @@ identifiers: *[ function/type ...]*
     .. kernel-doc:: lib/idr.c
        :identifiers:
 
+no-identifiers: *[ function/type ...]*
+  Exclude documentation for each *function* and *type* in *source*.
+
+  Example::
+
+    .. kernel-doc:: lib/bitmap.c
+       :no-identifiers: bitmap_parselist
+
 functions: *[ function/type ...]*
   This is an alias of the 'identifiers' directive and deprecated.
 

Documentation/driver-api/basics.rst

View file

diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api/basics.rst
index 1ba88c7..3e2dae9 100644
--- a/Documentation/driver-api/basics.rst
+++ b/Documentation/driver-api/basics.rst
@@ -12,6 +12,8 @@ Driver device table
 
 .. kernel-doc:: include/linux/mod_devicetable.h
    :internal:
+   :no-identifiers: pci_device_id
+
 
 Delaying, scheduling, and timer routines
 ----------------------------------------
@@ -55,15 +57,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
 ------------------
 
@@ -105,19 +98,15 @@ Kernel utility functions
 
 .. kernel-doc:: include/linux/kernel.h
    :internal:
+   :no-identifiers: kstrtol kstrtoul
 
 .. kernel-doc:: kernel/printk/printk.c
    :export:
+   :no-identifiers: printk
 
 .. kernel-doc:: kernel/panic.c
    :export:
 
-.. kernel-doc:: kernel/rcu/tree.c
-   :export:
-
-.. kernel-doc:: kernel/rcu/update.c
-   :export:
-
 .. kernel-doc:: include/linux/overflow.h
    :internal:
 

Documentation/driver-api/device_link.rst

View file

diff --git a/Documentation/driver-api/device_link.rst b/Documentation/driver-api/device_link.rst
index bc2d89a..ee913ae 100644
--- a/Documentation/driver-api/device_link.rst
+++ b/Documentation/driver-api/device_link.rst
@@ -1,7 +1,3 @@
-.. |struct dev_pm_domain| replace:: :c:type:`struct dev_pm_domain <dev_pm_domain>`
-.. |struct generic_pm_domain| replace:: :c:type:`struct generic_pm_domain <generic_pm_domain>`
-
-
 .. _device_link:
 
 ============
@@ -166,7 +162,7 @@ Examples
   is the same as if the MMU was the parent of the master device.
 
   The fact that both devices share the same power domain would normally
-  suggest usage of a |struct dev_pm_domain| or |struct generic_pm_domain|,
+  suggest usage of a struct dev_pm_domain or struct generic_pm_domain,
   however these are not independent devices that happen to share a power
   switch, but rather the MMU device serves the busmaster device and is
   useless without it.  A device link creates a synthetic hierarchical
@@ -202,7 +198,7 @@ Examples
 Alternatives
 ============
 
-* A |struct dev_pm_domain| can be used to override the bus,
+* A struct dev_pm_domain can be used to override the bus,
   class or device type callbacks.  It is intended for devices sharing
   a single on/off switch, however it does not guarantee a specific
   suspend/resume ordering, this needs to be implemented separately.
@@ -211,7 +207,7 @@ Alternatives
   suspended.  Furthermore it cannot be used to enforce a specific shutdown
   ordering or a driver presence dependency.
 
-* A |struct generic_pm_domain| is a lot more heavyweight than a
+* A struct generic_pm_domain is a lot more heavyweight than a
   device link and does not allow for shutdown ordering or driver presence
   dependencies.  It also cannot be used on ACPI systems.
 
@@ -321,5 +317,4 @@ State machine
 API
 ===
 
-.. kernel-doc:: drivers/base/core.c
-   :functions: device_link_add device_link_del device_link_remove
+See device_link_add(), device_link_del() and device_link_remove().

Documentation/driver-api/fpga/fpga-bridge.rst

View file

diff --git a/Documentation/driver-api/fpga/fpga-bridge.rst b/Documentation/driver-api/fpga/fpga-bridge.rst
index ccd677b..198aada 100644
--- a/Documentation/driver-api/fpga/fpga-bridge.rst
+++ b/Documentation/driver-api/fpga/fpga-bridge.rst
@@ -4,8 +4,8 @@ FPGA Bridge
 API to implement a new FPGA bridge
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* struct :c:type:`fpga_bridge` — The FPGA Bridge structure
-* struct :c:type:`fpga_bridge_ops` — Low level Bridge driver ops
+* struct fpga_bridge — The FPGA Bridge structure
+* struct fpga_bridge_ops — Low level Bridge driver ops
 * devm_fpga_bridge_create() — Allocate and init a bridge struct
 * fpga_bridge_register() — Register a bridge
 * fpga_bridge_unregister() — Unregister a bridge

Documentation/driver-api/fpga/fpga-mgr.rst

View file

diff --git a/Documentation/driver-api/fpga/fpga-mgr.rst b/Documentation/driver-api/fpga/fpga-mgr.rst
index af5382a..917ee22 100644
--- a/Documentation/driver-api/fpga/fpga-mgr.rst
+++ b/Documentation/driver-api/fpga/fpga-mgr.rst
@@ -101,9 +101,9 @@ in state.
 API for implementing a new FPGA Manager driver
 ----------------------------------------------
 
-* ``fpga_mgr_states`` —  Values for :c:member:`fpga_manager->state`.
-* struct :c:type:`fpga_manager` —  the FPGA manager struct
-* struct :c:type:`fpga_manager_ops` —  Low level FPGA manager driver ops
+* ``fpga_mgr_states`` —  Values for :c:expr:`fpga_manager->state`.
+* struct fpga_manager —  the FPGA manager struct
+* struct fpga_manager_ops —  Low level FPGA manager driver ops
 * devm_fpga_mgr_create() —  Allocate and init a manager struct
 * fpga_mgr_register() —  Register an FPGA manager
 * fpga_mgr_unregister() —  Unregister an FPGA manager

Documentation/driver-api/fpga/fpga-programming.rst

View file

diff --git a/Documentation/driver-api/fpga/fpga-programming.rst b/Documentation/driver-api/fpga/fpga-programming.rst
index f487ad6..002392d 100644
--- a/Documentation/driver-api/fpga/fpga-programming.rst
+++ b/Documentation/driver-api/fpga/fpga-programming.rst
@@ -15,7 +15,7 @@ the FPGA manager and bridges.  It will:
  * lock the mutex of the region's FPGA manager
  * build a list of FPGA bridges if a method has been specified to do so
  * disable the bridges
- * program the FPGA using info passed in :c:member:`fpga_region->info`.
+ * program the FPGA using info passed in :c:expr:`fpga_region->info`.
  * re-enable the bridges
  * release the locks
 

Documentation/driver-api/fpga/fpga-region.rst

View file

diff --git a/Documentation/driver-api/fpga/fpga-region.rst b/Documentation/driver-api/fpga/fpga-region.rst
index 31118a8..363a817 100644
--- a/Documentation/driver-api/fpga/fpga-region.rst
+++ b/Documentation/driver-api/fpga/fpga-region.rst
@@ -45,7 +45,7 @@ An example of usage can be seen in the probe function of [#f2]_.
 API to add a new FPGA region
 ----------------------------
 
-* struct :c:type:`fpga_region` — The FPGA region struct
+* struct fpga_region — The FPGA region struct
 * devm_fpga_region_create() — Allocate and init a region struct
 * fpga_region_register() —  Register an FPGA region
 * fpga_region_unregister() —  Unregister an FPGA region
@@ -61,9 +61,9 @@ during the region's probe function.
 
 The FPGA region will need to specify which bridges to control while programming
 the FPGA.  The region driver can build a list of bridges during probe time
-(:c:member:`fpga_region->bridge_list`) or it can have a function that creates
+(:c:expr:`fpga_region->bridge_list`) or it can have a function that creates
 the list of bridges to program just before programming
-(:c:member:`fpga_region->get_bridges`).  The FPGA bridge framework supplies the
+(:c:expr:`fpga_region->get_bridges`).  The FPGA bridge framework supplies the
 following APIs to handle building or tearing down that list.
 
 * fpga_bridge_get_to_list() — Get a ref of an FPGA bridge, add it to a

Documentation/driver-api/iio/buffers.rst

View file

diff --git a/Documentation/driver-api/iio/buffers.rst b/Documentation/driver-api/iio/buffers.rst
index dd64c9c..3ddebdd 100644
--- a/Documentation/driver-api/iio/buffers.rst
+++ b/Documentation/driver-api/iio/buffers.rst
@@ -2,7 +2,7 @@
 Buffers
 =======
 
-* struct :c:type:`iio_buffer` — general buffer structure
+* struct iio_buffer — general buffer structure
 * :c:func:`iio_validate_scan_mask_onehot` — Validates that exactly one channel
   is selected
 * :c:func:`iio_buffer_get` — Grab a reference to the buffer

Documentation/driver-api/iio/core.rst

View file

diff --git a/Documentation/driver-api/iio/core.rst b/Documentation/driver-api/iio/core.rst
index 51b21e0..715cf29 100644
--- a/Documentation/driver-api/iio/core.rst
+++ b/Documentation/driver-api/iio/core.rst
@@ -10,7 +10,7 @@ applications manipulating sensors. The implementation can be found under
 Industrial I/O Devices
 ----------------------
 
-* struct :c:type:`iio_dev` - industrial I/O device
+* struct iio_dev - industrial I/O device
 * iio_device_alloc() - allocate an :c:type:`iio_dev` from a driver
 * iio_device_free() - free an :c:type:`iio_dev` from a driver
 * iio_device_register() - register a device with the IIO subsystem
@@ -66,7 +66,7 @@ Common attributes are:
 IIO device channels
 ===================
 
-struct :c:type:`iio_chan_spec` - specification of a single channel
+struct iio_chan_spec - specification of a single channel
 
 An IIO device channel is a representation of a data channel. An IIO device can
 have one or multiple channels. For example:
@@ -77,7 +77,7 @@ have one or multiple channels. For example:
 * an accelerometer can have up to 3 channels representing acceleration on X, Y