]> git.baikalelectronics.ru Git - kernel.git/commit
docs-rst: auto-generate PDF image files
authorMauro Carvalho Chehab <mchehab@osg.samsung.com>
Mon, 14 Nov 2016 16:32:32 +0000 (14:32 -0200)
committerJonathan Corbet <corbet@lwn.net>
Wed, 16 Nov 2016 22:20:59 +0000 (15:20 -0700)
commit92e598ef8ed5f1d2bf3df952d0bd5789a933acb0
tree9d4e655552bafc4e520a98c602f68ae6dea0c7a3
parentf494ddb7fdfae2cfb931275fb82fe12aebd72759
docs-rst: auto-generate PDF image files

The PDF files that contain media images were actually generated
offline from their SVG or PNG source files.

Sphinx can handle PNG sources automatially. So, let's just
drop their PDF counterparts.

For SVG, however, Sphinx doesn't produce the right tags to
use the TexLive SVG support. Also, the SVG support is done via
shell execution, with is not nice.

So, while we don't have any support for SVG inside Sphinx
core or as an extension, move the logic to build them to Makefile,
producing the PDF images on runtime.

NOTE: due to the way Sphinx works, the PDF images should be
generated inside the Kernel source tree, as otherwise Sphinx
won't find it, not obeying what's specified by "O=" makefile
parameter.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
59 files changed:
Documentation/Makefile.sphinx
Documentation/media/.gitignore [new file with mode: 0644]
Documentation/media/Makefile
Documentation/media/intro.rst
Documentation/media/media_api_files/typical_media_device.pdf [deleted file]
Documentation/media/media_api_files/typical_media_device.svg [deleted file]
Documentation/media/typical_media_device.svg [new file with mode: 0644]
Documentation/media/uapi/dvb/dvbstb.svg [new file with mode: 0644]
Documentation/media/uapi/dvb/intro.rst
Documentation/media/uapi/dvb/intro_files/dvbstb.pdf [deleted file]
Documentation/media/uapi/dvb/intro_files/dvbstb.svg [deleted file]
Documentation/media/uapi/v4l/bayer.png [new file with mode: 0644]
Documentation/media/uapi/v4l/constraints.svg [new file with mode: 0644]
Documentation/media/uapi/v4l/crop.png [new file with mode: 0644]
Documentation/media/uapi/v4l/crop.rst
Documentation/media/uapi/v4l/crop_files/crop.pdf [deleted file]
Documentation/media/uapi/v4l/crop_files/crop.png [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi.rst
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_525.png [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.png [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.pdf [deleted file]
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.png [deleted file]
Documentation/media/uapi/v4l/dev-subdev.rst
Documentation/media/uapi/v4l/dev-subdev_files/pipeline.pdf [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/pipeline.png [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-crop.pdf [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-crop.svg [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-full.pdf [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-full.svg [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.pdf [deleted file]
Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.svg [deleted file]
Documentation/media/uapi/v4l/field-order.rst
Documentation/media/uapi/v4l/field-order_files/fieldseq_bt.pdf [deleted file]
Documentation/media/uapi/v4l/field-order_files/fieldseq_bt.png [deleted file]
Documentation/media/uapi/v4l/field-order_files/fieldseq_tb.pdf [deleted file]
Documentation/media/uapi/v4l/field-order_files/fieldseq_tb.png [deleted file]
Documentation/media/uapi/v4l/fieldseq_bt.png [new file with mode: 0644]
Documentation/media/uapi/v4l/fieldseq_tb.png [new file with mode: 0644]
Documentation/media/uapi/v4l/nv12mt.png [new file with mode: 0644]
Documentation/media/uapi/v4l/nv12mt_example.png [new file with mode: 0644]
Documentation/media/uapi/v4l/pipeline.png [new file with mode: 0644]
Documentation/media/uapi/v4l/pixfmt-nv12mt.rst
Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt.png [deleted file]
Documentation/media/uapi/v4l/pixfmt-nv12mt_files/nv12mt_example.png [deleted file]
Documentation/media/uapi/v4l/selection-api-003.rst
Documentation/media/uapi/v4l/selection-api-003_files/selection.png [deleted file]
Documentation/media/uapi/v4l/selection.png [new file with mode: 0644]
Documentation/media/uapi/v4l/subdev-formats.rst
Documentation/media/uapi/v4l/subdev-formats_files/bayer.png [deleted file]
Documentation/media/uapi/v4l/subdev-image-processing-crop.svg [new file with mode: 0644]
Documentation/media/uapi/v4l/subdev-image-processing-full.svg [new file with mode: 0644]
Documentation/media/uapi/v4l/subdev-image-processing-scaling-multi-source.svg [new file with mode: 0644]
Documentation/media/uapi/v4l/vbi_525.png [new file with mode: 0644]
Documentation/media/uapi/v4l/vbi_625.png [new file with mode: 0644]
Documentation/media/uapi/v4l/vbi_hsync.png [new file with mode: 0644]
Documentation/media/uapi/v4l/vidioc-g-selection.rst
Documentation/media/uapi/v4l/vidioc-g-selection_files/constraints.svg [deleted file]