Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751961AbdHGU1g (ORCPT ); Mon, 7 Aug 2017 16:27:36 -0400 Received: from ms.lwn.net ([45.79.88.28]:60876 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751743AbdHGU1f (ORCPT ); Mon, 7 Aug 2017 16:27:35 -0400 Date: Mon, 7 Aug 2017 14:27:33 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org Subject: Re: [PATCH] scripts/sphinx-pre-install: add minimum support for RHEL Message-ID: <20170807142733.6642b226@lwn.net> In-Reply-To: References: Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1084 Lines: 31 On Mon, 24 Jul 2017 09:09:24 -0300 Mauro Carvalho Chehab 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