[PATCH v2 00/14] Fix PDF doc builds on major distros

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

Hi Jon,

Here it is the second version of the PDF series. I opted to split one of
the patches in 3, to have a clearer changelog and description.

Also, archlinux LXC image download started working again, so I added
an extra patch addressing texlive packae dependencies.

This series is taking me a way more time than antecipated.

This series as 3 goals:

1. Fix a pre-Sphinx 1.7 PDF variable that got renamed, but
   our Makefile still uses the old one that is not supported
   since Sphinx 1.7;

2. Fix broken or incomplete texlive dependencies on several
   distros;

4. "modernize" conf.py to solve font conflicts related to UTF-8
   and non-UTF fonts from [T1]{fontenc}  LaTeX package.

   Using fontenc with xelatex is problematic, as documented at

	https://www.sphinx-doc.org/en/master/latex.html

Please notice that:

- It doesn't pretend to fix all  PDF issues. It focus only at the
  above;
- there are still distros where PDF builds fail either partially
  or as a hole. On my checks, those are due to problematic
  texlive packages shipped on such distros;
- it doesn't touch/address/alter anyhing related to kfigure.py.
  as such, it doesn't touch/change/improve/drop anything with
  regards ImageMagick and/or Inkscape.

I think we need a separate series addressing kfigure.py:
it currently breaks if either input or output has a char > 127,
meaning that PDF output there may eventually break.

---
v2:
  - one of the conf.py packages were split to help reviewers
    to check the actual changes;
  - added an extra sphinx-pre-install patch for ArchLinux.

Mauro Carvalho Chehab (14):
  docs: Makefile: Fix LaTeX paper size settings
  docs: conf.py: better handle latex documents
  docs: conf.py: fix doc name with SPHINXDIRS
  docs: conf.py: rename some vars at latex_documents logic
  docs: conf.py: use dedent and r-strings for LaTeX macros
  docs: conf.py: fix some troubles for LaTeX output
  docs: conf.py: extra cleanups and fixes
  scripts: sphinx-pre-install: fix PDF build issues on Ubuntu
  scripts: sphinx-pre-install: add missing gentoo pdf dependencies
  scripts: sphinx-pre-install: fix PDF dependencies for openSuse
  scripts: sphinx-pre-install: fix dependencies for OpenMandriva
  scripts: sphinx-pre-install: fix pdf dependencies for Mageia 9
  scripts: sphinx-pre-install: fix PDF dependencies for gentoo
  scripts/sphinx-pre-install: fix Archlinux PDF dependencies

 Documentation/Makefile     |   4 +-
 Documentation/conf.py      | 106 ++++++++++++++++++++++---------------
 scripts/sphinx-pre-install |  46 ++++++++++++----
 3 files changed, 101 insertions(+), 55 deletions(-)

-- 
2.50.1