[PATCH 00/12] media documentation ReST fixes

From: Mauro Carvalho Chehab
Date: Sat Sep 02 2017 - 22:36:27 EST


This series contain media documentation ReST fixes, mostly related to
table parsing and the corresponding PDF output (tested with Sphinx 1.4).

It also contains a few documentation trivial improvements, from a
few minor issues I noticed when reading the PDF output text on some
places.

Probably the most important one is a regression that was causing the
media book build to return an error, introduced by changeset
70b074df4ed1 ("media: fix pdf build with Spinx 1.6").

My plan is to merge this patch series soon via the media tree,
and send it upstream during this merge window.

Markus,

Perhaps you could take a look on it. It is related to the usage of cspan
and the corresponding PDF output.

Mauro Carvalho Chehab (12):
media: v4l uAPI: add descriptions for arguments to all ioctls
media: vidioc-querycap: use a more realistic value for KERNEL_VERSION
media: vidioc-g-tuner.rst: Fix table number of cols
media: v4l uAPI docs: adjust some tables for PDF output
media: docs: fix PDF build with Sphinx 1.4
media: rc-sysfs-nodes.rst: better use literals
media: mc uapi: adjust some table sizes for PDF output
media: cec uapi: Adjust table sizes for PDF output
media: docs: don't show ToC for each part on PDF output
media: v4l2-event.rst: adjust table to fit on PDF output
media: em28xx-cardlist.rst: update to reflect last changes
media: docs-rst: cardlists: change their format to flat-tables

Documentation/media/cec-drivers/index.rst | 4 +-
Documentation/media/dvb-drivers/index.rst | 4 +-
Documentation/media/kapi/v4l2-event.rst | 2 +
Documentation/media/media_kapi.rst | 4 +-
Documentation/media/media_uapi.rst | 4 +-
Documentation/media/uapi/cec/cec-api.rst | 5 +-
.../media/uapi/cec/cec-ioc-adap-g-log-addrs.rst | 7 +-
Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 9 +-
Documentation/media/uapi/cec/cec-ioc-g-mode.rst | 2 +
Documentation/media/uapi/cec/cec-ioc-receive.rst | 2 +
Documentation/media/uapi/dvb/dvbapi.rst | 4 +-
.../media/uapi/mediactl/media-controller.rst | 4 +-
.../uapi/mediactl/media-ioc-enum-entities.rst | 2 +-
.../media/uapi/mediactl/media-ioc-g-topology.rst | 2 +-
Documentation/media/uapi/mediactl/media-types.rst | 2 +-
Documentation/media/uapi/rc/rc-sysfs-nodes.rst | 10 +-
Documentation/media/uapi/rc/remote_controllers.rst | 4 +-
Documentation/media/uapi/v4l/colorspaces-defs.rst | 2 +
Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 6 +-
Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst | 3 +-
Documentation/media/uapi/v4l/pixfmt-srggb10p.rst | 2 +-
.../media/uapi/v4l/v4l2-selection-targets.rst | 2 +-
Documentation/media/uapi/v4l/v4l2.rst | 4 +-
.../media/uapi/v4l/vidioc-create-bufs.rst | 1 +
Documentation/media/uapi/v4l/vidioc-cropcap.rst | 1 +
.../media/uapi/v4l/vidioc-dbg-g-chip-info.rst | 1 +
.../media/uapi/v4l/vidioc-dbg-g-register.rst | 1 +
Documentation/media/uapi/v4l/vidioc-dqevent.rst | 1 +
.../media/uapi/v4l/vidioc-dv-timings-cap.rst | 1 +
.../media/uapi/v4l/vidioc-encoder-cmd.rst | 2 +-
.../media/uapi/v4l/vidioc-enum-dv-timings.rst | 1 +
Documentation/media/uapi/v4l/vidioc-enum-fmt.rst | 1 +
.../media/uapi/v4l/vidioc-enum-frameintervals.rst | 5 +-
.../media/uapi/v4l/vidioc-enum-framesizes.rst | 4 +-
.../media/uapi/v4l/vidioc-enum-freq-bands.rst | 1 +
Documentation/media/uapi/v4l/vidioc-enumaudio.rst | 1 +
.../media/uapi/v4l/vidioc-enumaudioout.rst | 1 +
Documentation/media/uapi/v4l/vidioc-enuminput.rst | 1 +
Documentation/media/uapi/v4l/vidioc-enumoutput.rst | 1 +
Documentation/media/uapi/v4l/vidioc-enumstd.rst | 1 +
Documentation/media/uapi/v4l/vidioc-expbuf.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-audio.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-audioout.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-crop.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-ctrl.rst | 1 +
.../media/uapi/v4l/vidioc-g-dv-timings.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-edid.rst | 1 +
.../media/uapi/v4l/vidioc-g-enc-index.rst | 1 +
.../media/uapi/v4l/vidioc-g-ext-ctrls.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-fbuf.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-fmt.rst | 1 +
.../media/uapi/v4l/vidioc-g-frequency.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-input.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst | 1 +
.../media/uapi/v4l/vidioc-g-modulator.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-output.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-parm.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-priority.rst | 2 +-
.../media/uapi/v4l/vidioc-g-selection.rst | 5 +-
.../media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-std.rst | 1 +
Documentation/media/uapi/v4l/vidioc-g-tuner.rst | 10 +-
Documentation/media/uapi/v4l/vidioc-overlay.rst | 1 +
.../media/uapi/v4l/vidioc-prepare-buf.rst | 1 +
Documentation/media/uapi/v4l/vidioc-qbuf.rst | 1 +
.../media/uapi/v4l/vidioc-query-dv-timings.rst | 1 +
Documentation/media/uapi/v4l/vidioc-querybuf.rst | 1 +
Documentation/media/uapi/v4l/vidioc-querycap.rst | 8 +-
Documentation/media/uapi/v4l/vidioc-queryctrl.rst | 2 +
Documentation/media/uapi/v4l/vidioc-querystd.rst | 1 +
Documentation/media/uapi/v4l/vidioc-reqbufs.rst | 2 +-
.../media/uapi/v4l/vidioc-s-hw-freq-seek.rst | 1 +
Documentation/media/uapi/v4l/vidioc-streamon.rst | 2 +-
.../uapi/v4l/vidioc-subdev-enum-frame-interval.rst | 1 +
.../uapi/v4l/vidioc-subdev-enum-frame-size.rst | 1 +
.../uapi/v4l/vidioc-subdev-enum-mbus-code.rst | 1 +
.../media/uapi/v4l/vidioc-subdev-g-crop.rst | 1 +
.../media/uapi/v4l/vidioc-subdev-g-fmt.rst | 1 +
.../uapi/v4l/vidioc-subdev-g-frame-interval.rst | 1 +
.../media/uapi/v4l/vidioc-subdev-g-selection.rst | 1 +
.../media/uapi/v4l/vidioc-subscribe-event.rst | 5 +-
.../media/v4l-drivers/au0828-cardlist.rst | 44 +-
Documentation/media/v4l-drivers/bttv-cardlist.rst | 849 +++++++++++++----
.../media/v4l-drivers/cx23885-cardlist.rst | 304 +++++--
Documentation/media/v4l-drivers/cx88-cardlist.rst | 469 ++++++++--
.../media/v4l-drivers/em28xx-cardlist.rst | 523 ++++++++---
Documentation/media/v4l-drivers/index.rst | 4 +-
Documentation/media/v4l-drivers/ivtv-cardlist.rst | 169 +++-
.../media/v4l-drivers/saa7134-cardlist.rst | 999 ++++++++++++++++-----
.../media/v4l-drivers/saa7164-cardlist.rst | 84 +-
.../media/v4l-drivers/tm6000-cardlist.rst | 99 +-
.../media/v4l-drivers/usbvision-cardlist.rst | 349 +++++--
92 files changed, 3240 insertions(+), 837 deletions(-)

--
2.13.5