Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1516256 > unrolled thread

[PATCH v2 0/6] Fix PDF builds on media documentation

Started byMauro Carvalho Chehab <mchehab@s-opensource.com>
First post2016-11-07 16:30 +0100
Last post2016-11-08 10:10 +0100
Articles 5 — 2 participants

Back to article view | Back to linux.kernel


Contents

  [PATCH v2 0/6] Fix PDF builds on media documentation Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-07 16:30 +0100
    Re: [PATCH v2 0/6] Fix PDF builds on media documentation Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-08 10:10 +0100
      Re: [PATCH v2 0/6] Fix PDF builds on media documentation Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-08 10:20 +0100
        Re: [PATCH v2 0/6] Fix PDF builds on media documentation Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-11-08 11:00 +0100
    Re: [PATCH v2 0/6] Fix PDF builds on media documentation Jani Nikula <jani.nikula@linux.intel.com> - 2016-11-08 10:10 +0100

#1516256 — [PATCH v2 0/6] Fix PDF builds on media documentation

FromMauro Carvalho Chehab <mchehab@s-opensource.com>
Date2016-11-07 16:30 +0100
Subject[PATCH v2 0/6] Fix PDF builds on media documentation
Message-ID<sAU1X-4T4-7@gated-at.bofh.it>
This series address a series of errors during PDF generation from
media documentation.

It replaces the previous patch series entitled:
	[PATCH RFC 0/4] Fix PDF build errors

The first patch fixes the late redefinition of a LaTeX command at the
Sphinx LaTeX style that causes build to break when some cross-references
are used.

The next two patches fix PDF output issues with subdev-formats.rst.

The next 3 patches fix image includes and their output for PDF.

It is aligned with Linus request of not having binary-generated images
from their PNG or SVG source codes.

I still intend to move the remaing PNG images to vectorial ones (SVG),
as image scale works better, but this will require some additional work.
When done, I'll submit as a separate patch series.

It should also be noticed that the last patch violates the output dir,
when make is used with "O=some_dir", as Sphinx doesn't accept
image files outside the source directory. We'll likely need some Sphinx
extension in order to fix it, but at least with this series (plus Jani Nikola's
PDF fix series), the PDF output should work fine again.

Mauro Carvalho Chehab (6):
  docs-rst: fix LaTeX \DURole renewcommand with Sphinx 1.3+
  [media] subdev-formats.rst: don't use adjustbox on a longtable
  [media] subdev-formats.rst: add missing columns to tabularcolumns
  [media] convert some images from png to svg
  [media] docs-rst: convert gif files to png
  [media] docs-rst: auto-generate PDF image files

 Documentation/Makefile.sphinx                      |   3 +-
 Documentation/conf.py                              |   6 +-
 Documentation/media/Makefile                       |  42 ++-
 Documentation/media/index.rst                      |   5 -
 Documentation/media/intro.rst                      |   4 +-
 .../media/media_api_files/typical_media_device.pdf | Bin 52895 -> 0 bytes
 .../{media_api_files => }/typical_media_device.svg |   0
 Documentation/media/uapi/dvb/dvbstb.svg            | 318 +++++++++++++++++++++
 Documentation/media/uapi/dvb/intro.rst             |   4 +-
 .../media/uapi/dvb/intro_files/dvbstb.pdf          | Bin 1881 -> 0 bytes
 .../media/uapi/dvb/intro_files/dvbstb.png          | Bin 22655 -> 0 bytes
 .../uapi/v4l/{subdev-formats_files => }/bayer.png  | Bin
 Documentation/media/uapi/v4l/constraints.svg       | 219 ++++++++++++++
 Documentation/media/uapi/v4l/crop.png              | Bin 0 -> 3334 bytes
 Documentation/media/uapi/v4l/crop.rst              |   4 +-
 Documentation/media/uapi/v4l/crop_files/crop.gif   | Bin 5967 -> 0 bytes
 Documentation/media/uapi/v4l/crop_files/crop.pdf   | Bin 5846 -> 0 bytes
 Documentation/media/uapi/v4l/dev-raw-vbi.rst       |  12 +-
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_525.gif   | Bin 4741 -> 0 bytes
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf   | Bin 3706 -> 0 bytes
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_625.gif   | Bin 5095 -> 0 bytes
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf   | Bin 3996 -> 0 bytes
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.gif | Bin 2400 -> 0 bytes
 .../media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.pdf | Bin 7405 -> 0 bytes
 Documentation/media/uapi/v4l/dev-subdev.rst        |  14 +-
 .../media/uapi/v4l/dev-subdev_files/pipeline.pdf   | Bin 20276 -> 0 bytes
 .../subdev-image-processing-crop.pdf               | Bin 20729 -> 0 bytes
 .../subdev-image-processing-full.pdf               | Bin 46311 -> 0 bytes
 ...ubdev-image-processing-scaling-multi-source.pdf | Bin 36714 -> 0 bytes
 Documentation/media/uapi/v4l/field-order.rst       |   8 +-
 .../uapi/v4l/field-order_files/fieldseq_bt.gif     | Bin 25430 -> 0 bytes
 .../uapi/v4l/field-order_files/fieldseq_bt.pdf     | Bin 9185 -> 0 bytes
 .../uapi/v4l/field-order_files/fieldseq_tb.gif     | Bin 25323 -> 0 bytes
 .../uapi/v4l/field-order_files/fieldseq_tb.pdf     | Bin 9173 -> 0 bytes
 Documentation/media/uapi/v4l/fieldseq_bt.png       | Bin 0 -> 12306 bytes
 Documentation/media/uapi/v4l/fieldseq_tb.png       | Bin 0 -> 12247 bytes
 .../uapi/v4l/{pixfmt-nv12mt_files => }/nv12mt.png  | Bin
 .../{pixfmt-nv12mt_files => }/nv12mt_example.png   | Bin
 .../uapi/v4l/{dev-subdev_files => }/pipeline.png   | Bin
 Documentation/media/uapi/v4l/pixfmt-nv12mt.rst     |   8 +-
 Documentation/media/uapi/v4l/selection-api-003.rst |   4 +-
 .../{selection-api-003_files => }/selection.png    | Bin
 Documentation/media/uapi/v4l/subdev-formats.rst    |  19 +-
 .../subdev-image-processing-crop.svg               |   0
 .../subdev-image-processing-full.svg               |   0
 ...ubdev-image-processing-scaling-multi-source.svg |   0
 Documentation/media/uapi/v4l/vbi_525.png           | Bin 0 -> 2053 bytes
 Documentation/media/uapi/v4l/vbi_625.png           | Bin 0 -> 2352 bytes
 Documentation/media/uapi/v4l/vbi_hsync.png         | Bin 0 -> 906 bytes
 .../media/uapi/v4l/vidioc-g-selection.rst          |   4 +-
 .../v4l/vidioc-g-selection_files/constraints.png   | Bin 3313 -> 0 bytes
 51 files changed, 628 insertions(+), 46 deletions(-)
 delete mode 100644 Documentation/media/media_api_files/typical_media_device.pdf
 rename Documentation/media/{media_api_files => }/typical_media_device.svg (100%)
 create mode 100644 Documentation/media/uapi/dvb/dvbstb.svg
 delete mode 100644 Documentation/media/uapi/dvb/intro_files/dvbstb.pdf
 delete mode 100644 Documentation/media/uapi/dvb/intro_files/dvbstb.png
 rename Documentation/media/uapi/v4l/{subdev-formats_files => }/bayer.png (100%)
 create mode 100644 Documentation/media/uapi/v4l/constraints.svg
 create mode 100644 Documentation/media/uapi/v4l/crop.png
 delete mode 100644 Documentation/media/uapi/v4l/crop_files/crop.gif
 delete mode 100644 Documentation/media/uapi/v4l/crop_files/crop.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_525.gif
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.gif
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.gif
 delete mode 100644 Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_hsync.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-subdev_files/pipeline.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-crop.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-full.pdf
 delete mode 100644 Documentation/media/uapi/v4l/dev-subdev_files/subdev-image-processing-scaling-multi-source.pdf
 delete mode 100644 Documentation/media/uapi/v4l/field-order_files/fieldseq_bt.gif
 delete mode 100644 Documentation/media/uapi/v4l/field-order_files/fieldseq_bt.pdf
 delete mode 100644 Documentation/media/uapi/v4l/field-order_files/fieldseq_tb.gif
 delete mode 100644 Documentation/media/uapi/v4l/field-order_files/fieldseq_tb.pdf
 create mode 100644 Documentation/media/uapi/v4l/fieldseq_bt.png
 create mode 100644 Documentation/media/uapi/v4l/fieldseq_tb.png
 rename Documentation/media/uapi/v4l/{pixfmt-nv12mt_files => }/nv12mt.png (100%)
 rename Documentation/media/uapi/v4l/{pixfmt-nv12mt_files => }/nv12mt_example.png (100%)
 rename Documentation/media/uapi/v4l/{dev-subdev_files => }/pipeline.png (100%)
 rename Documentation/media/uapi/v4l/{selection-api-003_files => }/selection.png (100%)
 rename Documentation/media/uapi/v4l/{dev-subdev_files => }/subdev-image-processing-crop.svg (100%)
 rename Documentation/media/uapi/v4l/{dev-subdev_files => }/subdev-image-processing-full.svg (100%)
 rename Documentation/media/uapi/v4l/{dev-subdev_files => }/subdev-image-processing-scaling-multi-source.svg (100%)
 create mode 100644 Documentation/media/uapi/v4l/vbi_525.png
 create mode 100644 Documentation/media/uapi/v4l/vbi_625.png
 create mode 100644 Documentation/media/uapi/v4l/vbi_hsync.png
 delete mode 100644 Documentation/media/uapi/v4l/vidioc-g-selection_files/constraints.png

-- 
2.7.4

[toc] | [next] | [standalone]


#1516974

FromJani Nikula <jani.nikula@linux.intel.com>
Date2016-11-08 10:10 +0100
Message-ID<sBazM-7oC-9@gated-at.bofh.it>
In reply to#1516256
On Tue, 08 Nov 2016, Jani Nikula <jani.nikula@linux.intel.com> wrote:
> On Mon, 07 Nov 2016, Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
>> This series address a series of errors during PDF generation from
>> media documentation.
>
> I'm missing patches 3-6 of this series, and so is the archive.

I meant 4-6.


>
> BR,
> Jani.

-- 
Jani Nikula, Intel Open Source Technology Center

[toc] | [prev] | [next] | [standalone]


#1516982

FromMauro Carvalho Chehab <mchehab@s-opensource.com>
Date2016-11-08 10:20 +0100
Message-ID<sBaJs-7rN-27@gated-at.bofh.it>
In reply to#1516974
Em Tue, 08 Nov 2016 11:04:55 +0200
Jani Nikula <jani.nikula@linux.intel.com> escreveu:

> On Tue, 08 Nov 2016, Jani Nikula <jani.nikula@linux.intel.com> wrote:
> > On Mon, 07 Nov 2016, Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:  
> >> This series address a series of errors during PDF generation from
> >> media documentation.  
> >
> > I'm missing patches 3-6 of this series, and so is the archive.  
> 
> I meant 4-6.

Hmm... patchwork got patches 4 and 6, but patch 5 is missed:
	https://patchwork.kernel.org/project/LKML/list/?submitter=141

Weird. Perhaps another DDoS attack at the Internet infrastructure,
affecting email delivers?

Patch 5 is just a GIF->PNG conversion patch:
	https://git.linuxtv.org/mchehab/experimental.git/commit/?h=pdf-fixes&id=8af9c8d33609fdb64ae9ecc66edd27719d16df62

I could try to resend, if you want, but perhaps vger doesn't like patches
with binary changes on it.

Thanks,
Mauro

[toc] | [prev] | [next] | [standalone]


#1517006

FromMauro Carvalho Chehab <mchehab@s-opensource.com>
Date2016-11-08 11:00 +0100
Message-ID<sBbma-7Et-27@gated-at.bofh.it>
In reply to#1516982
Em Tue, 8 Nov 2016 07:19:38 -0200
Mauro Carvalho Chehab <mchehab@s-opensource.com> escreveu:

> Em Tue, 08 Nov 2016 11:04:55 +0200
> Jani Nikula <jani.nikula@linux.intel.com> escreveu:
> 
> > On Tue, 08 Nov 2016, Jani Nikula <jani.nikula@linux.intel.com> wrote:  
> > > On Mon, 07 Nov 2016, Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:    
> > >> This series address a series of errors during PDF generation from
> > >> media documentation.    
> > >
> > > I'm missing patches 3-6 of this series, and so is the archive.    
> > 
> > I meant 4-6.  
> 
> Hmm... patchwork got patches 4 and 6, but patch 5 is missed:
> 	https://patchwork.kernel.org/project/LKML/list/?submitter=141
> 
> Weird. Perhaps another DDoS attack at the Internet infrastructure,
> affecting email delivers?
> 
> Patch 5 is just a GIF->PNG conversion patch:
> 	https://git.linuxtv.org/mchehab/experimental.git/commit/?h=pdf-fixes&id=8af9c8d33609fdb64ae9ecc66edd27719d16df62
> 
> I could try to resend, if you want, but perhaps vger doesn't like patches
> with binary changes on it.

Re-sent the rebased version, explicitly C/C you.

Regards,
Mauro

[toc] | [prev] | [next] | [standalone]


#1516975

FromJani Nikula <jani.nikula@linux.intel.com>
Date2016-11-08 10:10 +0100
Message-ID<sBazM-7oC-11@gated-at.bofh.it>
In reply to#1516256
On Mon, 07 Nov 2016, Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
> This series address a series of errors during PDF generation from
> media documentation.

I'm missing patches 3-6 of this series, and so is the archive.

BR,
Jani.

-- 
Jani Nikula, Intel Open Source Technology Center

[toc] | [prev] | [standalone]


Back to top | Article view | linux.kernel


csiph-web