Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Date:   Thu, 7 Jul 2022 21:25:36 +0100
From:   Mauro Carvalho Chehab <mchehab@kernel.org>
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     Akira Yokosawa <akiyks@gmail.com>,
        ksummit-discuss@lists.linuxfoundation.org,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
        mchehab+huawei@kernel.org
Subject: Re: [PATCH v2 0/5] Address some issues with sphinx detection
Message-ID: <20220707212536.58026d99@sal.lan>
In-Reply-To: <87ilo8bw3p.fsf@meer.lwn.net>
References: <cover.1656756450.git.mchehab@kernel.org>
        <d0e1a08a-b965-ada6-e026-4e1cc38fbd90@gmail.com>
        <87ilo8bw3p.fsf@meer.lwn.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Precedence: bulk

Em Thu, 07 Jul 2022 12:45:14 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> Akira Yokosawa <akiyks@gmail.com> writes:
> 
> > TL;DR, my suggestion of options and defaults to sphinx-pre-install:
> >
> >     --no-pdf (default): for htmldocs only
> >     --no-virtualenv (default): distro Sphinx package
> >          (mention --virtualenv if distro Sphinx package is too young)
> >     --virtualenv: Sphinx by venv/virtualenv
> >     --pdf: for pdfdocs
> >         --no-cjk (default): don't bother with CJK pdfdocs
> >         --cjk: for CJK pdfdocs
> >                (print warning if user's distro doesn't support CJK)
> > Thoughts?  
> 
> I think this makes sense.  As far as I can tell, PDF builds are a
> relative rarity these days, and most people would rather not have to
> deal with virtualenv if they can avoid it.  We should definitely
> emphasize native installs whenever that can work.
> 
> I'm planning to go ahead and apply Mauro's sphinx-pre-install patches
> since they make things better, but then we should look at these tweaks.

IMO it makes sense to apply them, as they address some existing issues
on it. 

We can improve the script later on with Akira's comments and after having 
some discussions about what would be the default behavior that would fit
better.

Regards,
Mauro