Re: [PATCH v2 00/10] Get rid of bitmap images

[Jonathan Corbet]

On Wed, 30 Nov 2016 08:00:10 -0200
Mauro Carvalho Chehab  wrote:

> The main goal of this patch series is to get rid of PNG images, using 
> either graphviz or SVG for images.

OK, no build problems this time around...  I've applied the set, thanks.

It occurs to me that the documentation of the requirements to build the
docs is probably falling behind at this point; I'll try to get to that
soon if nobody beats me to it.

Thanks,

jon
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH v2 00/10] Get rid of bitmap images

[Mauro Carvalho Chehab]

The main goal of this patch series is to get rid of PNG images, using 
either graphviz or SVG for images.

I appended one unrelated patch in the end with some documentation
changes for parse_headers.pl.

In order to get rid of PNG, for old images generated with xfig,
stored inside PDF, just convert them to SVG and cleanup the
images using inkscape.

The pipeline image is actually a graphviz diagram. So, I wrote
an equivalent diagram in Graphviz, and add support to use
*.dot files, converting them to SVG.

The other bitmap images were rewritten in SVG from scratch.

For now, I'm keeping the image conversion rules inside the
Documentation/media/Makefile. I have a patch moving them to
Documentation/Makefile.sphinx at:

https://git.linuxtv.org/mchehab/experimental.git/commit/?h=svg-images-v2

but, as there's an extension being developed to do such 
conversion on the fly, I'm not including such patch in this
series.

NOTE: some images use more than 998 columns, causing troubles
with some MTA and MUA that could refuse them, because of an
IETF RFC 2821 violation:

$ git send-email patches/tmp
fatal: patches/tmp/0001-media-convert-more-media-images-to-SVG.patch: 
191: patch contains a line longer than 998 characters

Due to that, in case you miss a patch, I'm also storing them
on my development tree at:
https://git.linuxtv.org/mchehab/experimental.git/log/?h=svg-images

It is based on docs-next tree.

Version 2:

- added a .gitignore to ignore the svg image generated
  from a *.dot file;
-  added a small fixup patch that makes pdfdocs build clean,
   replacing fieldseq_bt.svg by fieldseq_bt.* at the .. figure:: tag.
- added the parse-headers.pl cleanup the documentation patch.

Mauro Carvalho Chehab (10):
  [media] convert more media images to SVG
  [media] svg files: cleanup them
  [media] docs-rst: nv12mt zigzag images: replace by SVG images
  [media] docs-rst: convert pipeline to SVG format
  [media] docs-rst: replace the selection.png by a SVG image
  [media] docs-rst: replace bayer.png by a SVG image
  docs-rst: media: build SVG from graphviz files
  docs-rst: media/Makefile: reorganize the rules
  docs-rst: fix media cleandocs target
  docs-rst: parse-headers.pl: cleanup the documentation

 Documentation/Makefile.sphinx  |2 +-
 Documentation/doc-guide/parse-headers.rst  |   22 +-
 Documentation/media/.gitignore |2 +
 Documentation/media/Makefile   |   67 +-
 Documentation/media/uapi/v4l/bayer.png |  Bin 9725 -> 0 bytes
 Documentation/media/uapi/v4l/bayer.svg |  984 
 Documentation/media/uapi/v4l/crop.png  |  Bin 3334 -> 0 bytes
 Documentation/media/uapi/v4l/crop.rst  |4 +-
 Documentation/media/uapi/v4l/crop.svg  |  281 +
 Documentation/media/uapi/v4l/dev-raw-vbi.rst   |   12 +-
 Documentation/media/uapi/v4l/dev-subdev.rst|4 +-
 Documentation/media/uapi/v4l/field-order.rst   |8 +-
 Documentation/media/uapi/v4l/fieldseq_bt.png   |  Bin 12306 -> 0 bytes
 Documentation/media/uapi/v4l/fieldseq_bt.svg   | 2613 +
 Documentation/media/uapi/v4l/fieldseq_tb.png   |  Bin 12247 -> 0 bytes
 Documentation/media/uapi/v4l/fieldseq_tb.svg   | 2607 +
 Documentation/media/uapi/v4l/nv12mt.png|  Bin 1920 -> 0 bytes
 Documentation/media/uapi/v4l/nv12mt.svg|  450 ++
 Documentation/media/uapi/v4l/nv12mt_example.png|  Bin 5261 -> 0 bytes
 Documentation/media/uapi/v4l/nv12mt_example.svg| 1589 ++
 Documentation/media/uapi/v4l/pipeline.dot  |   12 +
 Documentation/media/uapi/v4l/pipeline.png  |  Bin 12130 -> 0 bytes
 Documentation/media/uapi/v4l/pixfmt-nv12mt.rst |8 +-
 Documentation/media/uapi/v4l/selection-api-003.rst |4 +-
 Documentation/media/uapi/v4l/selection.png |  Bin 11716 -> 0 bytes
 Documentation/media/uapi/v4l/selection.svg | 5812 
 Documentation/media/uapi/v4l/subdev-formats.rst|4 +-
 .../uapi/v4l/subdev-image-processing-crop.svg  |  346 +-
 .../uapi/v4l/subdev-image-processing-full.svg  |  892 ++-
 ...ubdev-image-processing-scaling-multi-source.svg |  626 ++-
 Documentation/media/uapi/v4l/vbi_525.png   |  Bin 2053 -> 0 bytes
 Documentation/media/uapi/v4l/vbi_525.svg   |  811 +++
 Documentation/media/uapi/v4l/vbi_625.png   |  Bin 2352 -> 0 bytes
 Documentation/media/uapi/v4l/vbi_625.svg   |  858 +++
 Documentation/media/uapi/v4l/vbi_hsync.png |  Bin 906 -> 0 bytes
 Documentation/media/uapi/v4l/vbi_hsync.svg |  313 ++
 Documentation/sphinx/parse-headers.pl  |  116 +-
 37 files changed, 17994 insertions(+), 453 deletions(-)
 delete mode 100644 Documentation/media/uapi/v4l/bayer.png
 create mode 100644 Documentation/media/uapi/v4l/bayer.svg
 delete mode 100644 Documentation/media/uapi/v4l/crop.png
 create mode 100644