lkml.org 
[lkml]   [2020]   [Sep]   [30]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    From
    Subject[PATCH v4 00/52] Fix html build with Sphinx 3.1 and above
    Date
    This series add proper support for Sphinx 3.1 and above for building the html docs.

    This series comes after the one I wrote fixing the warnings.

    With this series applied on the top of next-20200922, there are just 12
    warnings:
    - 2 of them happens also on Sphinx 2.4.4
    (both seem easy to fix: I'll send later fixes for those);
    - 10 happens only on Sphinx 3.2.1.

    The new warnings are all due to duplicated C domain cross-reference symbols.

    Basically, the C domain on Sphinx doesn't allow to have an struct and
    a function with the same name. I opened an issue on Sphinx.:

    https://github.com/sphinx-doc/sphinx/issues/8241

    Hopefully, some newer version may have it fixed.

    There is still one thing that requires a fix: the automarkup.py. The
    way cross-references are stored with Sphinx 3 are different.
    I didn't try yet to address it, but I suspect that it shouldn't be
    hard to address it.

    Mauro Carvalho Chehab (52):
    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: conf.py: disable automarkup for Sphinx 3.x
    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
    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
    math64.h: kernel-docs: Convert some markups into normal comments
    memblock: get rid of a :c:type leftover
    drm: drm_dsc.h: fix a kernel-doc markup
    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: net: statistics.rst: remove a duplicated kernel-doc
    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: typec_bus.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
    workqueue: fix a kernel-doc warning
    scripts: kernel-doc: try to use c:function if possible
    docs: conf.py: fix c:function support with Sphinx 3.x
    docs: conf.py: change the Sphinx 3.x+ text

    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 | 68 ++++-
    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 +-
    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 | 3 -
    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/filesystems/fscrypt.rst | 61 ++---
    Documentation/filesystems/fsverity.rst | 2 +-
    Documentation/gpu/i915.rst | 29 ++-
    Documentation/networking/ieee802154.rst | 18 +-
    Documentation/networking/statistics.rst | 3 +-
    Documentation/sound/designs/tracepoints.rst | 22 +-
    .../sound/kernel-api/alsa-driver-api.rst | 1 +
    .../kernel-api/writing-an-alsa-driver.rst | 110 ++++----
    Documentation/sphinx/cdomain.py | 93 ++++++-
    Documentation/sphinx/kerneldoc.py | 10 +-
    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 +
    .../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 | 14 +-
    .../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 +-
    Documentation/vm/ksm.rst | 2 +-
    Documentation/vm/memory-model.rst | 6 +-
    include/drm/drm_dsc.h | 2 +-
    include/linux/math64.h | 8 +-
    kernel/workqueue.c | 3 +
    mm/ksm.c | 2 +-
    mm/memblock.c | 8 +-
    scripts/kernel-doc | 246 ++++++++++++------
    288 files changed, 1709 insertions(+), 2183 deletions(-)
    delete mode 100644 Documentation/driver-api/sound.rst

    --
    2.26.2


    \
     
     \ /
      Last update: 2020-09-30 15:27    [W:4.089 / U:0.008 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site