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


Groups > linux.kernel > #1668696

Re: [PATCH 0/5] Make PDF builds work again

From Mauro Carvalho Chehab <mchehab@s-opensource.com>
Newsgroups linux.kernel
Subject Re: [PATCH 0/5] Make PDF builds work again
Date 2017-06-19 03:20 +0200
Message-ID <tTTwd-4hF-3@gated-at.bofh.it> (permalink)
References <tTS78-3fw-1@gated-at.bofh.it>
Organization Samsung

Show all headers | View raw


Hi Jon,

Em Sun, 18 Jun 2017 17:46:25 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> I've just spent rather more time than I would like figuring out why the PDF
> builds fail and what was needed to fix it.  The result is the following
> patch series.  It's a combination of little mistakes and fragility in the
> whole PDF build tool chain.

Yeah, the PDF toolchain is very fragile. Yet, I'm pretty sure I was able
to build PDF in the past without noticing the problems fixed by patches
1 and 2. Maybe the bugs has to do with some specific incompatibility with
toolchain versions.

What Sphinx version are you using?

It is too late now, but tomorrow I'll test with a few Spinx versions
and see if PDF builds equally well with them.

> 
> Mauro, Daniel: Do you want the last two?  Or otherwise give me acks?  I'd
> like to send the set Linusward forthwith so that 4.12 can come out with
> a working PDF build.

For the media and EDAC changes (patches 3 and 4), once I test it,
feel free to add my ack and send via your tree:

Acked-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>

> 
> In general, I'm dismayed by the fragility of the whole thing.  I'm also a
> little concerned that nobody except Jim complained about the problem.

Actually, despite any "errors", usually it produces the PDF files.
I have a robot building just the media documentation, daily basis,
from media development tree, at:
	https://linuxtv.org/downloads/v4l-dvb-apis-new/media.pdf

The robot is using Sphinx 1.4.8 version.
	
> Perhaps nobody really cares about PDF output anymore?  In the absence of a
> concerted effort on somebody's part, I predict that PDF building will be
> broken much of the time.  I have to wonder if it's worth it...
> 
> Jonathan Corbet (5):
>   Docs: Include the Latex "ifthen" package
>   Docs: Remove redundant geometry package inclusion
>   Docs: fix table problems in ras.rst
>   Docs: Use kernel-figure in vidioc-g-selection.rst
>   DRM: Fix an incorrectly formatted table
> 
>  Documentation/admin-guide/ras.rst                  | 10 ++--
>  Documentation/conf.py                              |  3 +-
>  .../media/uapi/v4l/vidioc-g-selection.rst          |  4 +-
>  include/drm/bridge/dw_hdmi.h                       | 70 +++++++++++-----------
>  4 files changed, 43 insertions(+), 44 deletions(-)
> 



Thanks,
Mauro

Back to linux.kernel | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

[PATCH 0/5] Make PDF builds work again Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  [PATCH 1/5] Docs: Include the Latex "ifthen" package Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  [PATCH 4/5] Docs: Use kernel-figure in vidioc-g-selection.rst Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  [PATCH 2/5] Docs: Remove redundant geometry package inclusion Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
    Re: [PATCH 2/5] Docs: Remove redundant geometry package inclusion Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-06-19 12:40 +0200
      Re: [PATCH 2/5] Docs: Remove redundant geometry package inclusion Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-06-19 12:50 +0200
  [PATCH 5/5] DRM: Fix an incorrectly formatted table Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  Re: [PATCH 0/5] Make PDF builds work again Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  [PATCH 3/5] Docs: fix table problems in ras.rst Jonathan Corbet <corbet@lwn.net> - 2017-06-19 01:50 +0200
  Re: [PATCH 0/5] Make PDF builds work again Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-06-19 03:20 +0200
    Re: [PATCH 0/5] Make PDF builds work again Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-06-19 16:50 +0200

csiph-web