Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
        id S1751997AbdGOB1t (ORCPT <rfc822;w@1wt.eu>);
        Fri, 14 Jul 2017 21:27:49 -0400
Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:47762
        "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org
        with ESMTP id S1751443AbdGOB1r (ORCPT
        <rfc822;linux-kernel@vger.kernel.org>);
        Fri, 14 Jul 2017 21:27:47 -0400
Date: Fri, 14 Jul 2017 22:27:37 -0300
From: Mauro Carvalho Chehab <mchehab@s-opensource.com>
To: Jim Davis <jim.epost@gmail.com>
Cc: Markus Heiser <markus.heiser@darmarit.de>,
        Linux Doc Mailing List <linux-doc@vger.kernel.org>,
        Mauro Carvalho Chehab <mchehab@infradead.org>,
        linux-kernel <linux-kernel@vger.kernel.org>,
        Jonathan Corbet <corbet@lwn.net>
Subject: Re: [PATCH RFC] scripts/sphinx-pre-install: add a script to check
 Sphinx install
Message-ID: <20170714222737.39f489c1@vento.lan>
In-Reply-To: <CA+r1ZhgBL8HGTEgKhA_fSkvViFc7B-KjwsO+JBb0xsLBZOn3fA@mail.gmail.com>
References: <7ab9f1045ad103f1da56cb6b19948ea107fdb272.1500050599.git.mchehab@s-opensource.com>
        <042D234A-6B3D-43D4-84BA-8332C0596AA4@darmarit.de>
        <CA+r1ZhgBL8HGTEgKhA_fSkvViFc7B-KjwsO+JBb0xsLBZOn3fA@mail.gmail.com>
Organization: Samsung
X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
Content-Length: 2127
Lines: 76

Em Fri, 14 Jul 2017 15:51:03 -0700
Jim Davis <jim.epost@gmail.com> escreveu:

> On Fri, Jul 14, 2017 at 10:35 AM, Markus Heiser
> <markus.heiser@darmarit.de> wrote:
> >
> >
> > Ok, this won't solve TeX installation problems of Linux distros,  
> 
> Which seems to be the thorniest problem.  It's one thing to identify
> which sphinx versions work, and another to figure out which of the
> metric boatload of TeX packages are needed.

Yes. That's likely the hardest part.

> On a fresh Fedora 26 install I was able to get "make pdfdocs" to build
> (hurrah!) after adding

Just sent a version 2 of the script, with support for Fedora 26.

I tested with a Fedora lxc container. The only package I had to manually
install there is perl. I'm pretty sure that a minimal Fedora image
(outside a LXC) already comes with perl, so I guess the script is
an improvement over manually checking all needed dependencies.

> ImageMagick
> latex
> sphinx-build
> texlive-adjustbox
> texlive-babel-english
> texlive-capt-of
> texlive-cm
> texlive-cmap
> texlive-ec
> texlive-eqparbox
> texlive-euenc
> texlive-fancyhdr
> texlive-fncychap
> texlive-framed
> texlive-hyphen-base
> texlive-mdwtools
> texlive-multirow
> texlive-parskip
> texlive-tablefootnote
> texlive-tabulary
> texlive-threeparttable
> texlive-titlesec
> texlive-unicode-data
> texlive-upquote
> texlive-wrapfig
> xelatex

There is a package called "python-sphinx-latex" that seems to install
almost everything needed for Fedora 26. This one, plus:
	xelatex
	texlive-adjustbox

It also optionally require DeJavu fonts.

are enough for PDF build. You still need:
	ImageMagick
	graphviz

for both html and pdf targets, if you want to have support for
images.
 
> which ended up installing about 160 RPMs.  Figuring out the right
> texlive parts wasn't much fun; footnote.sty is well-hidden in
> texlive-mdwtools, for instance, and without texlive-babel-english the
> build failed with very mysterious errors in userspace-api.

Yeah, that's why I think the right solution is to have a script that
will identify the distribution and install the missing dependencies.

Thanks,
Mauro