Re: [PATCH] scripts/sphinx-pre-install: add minimum support for RHEL

From: Jonathan Corbet
Date: Mon Aug 07 2017 - 16:27:40 EST


On Mon, 24 Jul 2017 09:09:24 -0300
Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx> wrote:

> RHEL 7.x and clone distros are shipped with Sphinx 1.1.x,
> with is incompatible with Kernel ReST markups.
>
> So, on those systems, the only alternative is to install
> it via a Python virtual environment.
>
> While seeking for "pip" on CentOS 7.3, I noticed that it
> is not really needed, as python-virtualenv has its version
> packaged there already. So, remove this from the list of
> requirements for all distributions.
>
> With regards to PDF, twe need at least texlive-tabulary
> extension, but that is not shipped there (at least on
> CentOS). So, disable PDF packages as a hole.
>
> Please notice, however, that texlive + amsmath is needed for
> ReST to properly handle ReST ".. math::" tags. Yet, Sphinx
> fall back to display the LaTeX math expressions as-is, if
> such extension is not available.
>
> So, let's just disable all texlive packages as a hole.

I've applied this, finally. Couldn't resist the temptation to fix "as a
whole" while I was at it :)

Thanks,

jon