From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8054BC43334 for ; Thu, 7 Jul 2022 20:25:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236548AbiGGUZp (ORCPT ); Thu, 7 Jul 2022 16:25:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58734 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236518AbiGGUZp (ORCPT ); Thu, 7 Jul 2022 16:25:45 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7B0D42409E; Thu, 7 Jul 2022 13:25:44 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 1A12B62392; Thu, 7 Jul 2022 20:25:44 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1C967C3411E; Thu, 7 Jul 2022 20:25:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1657225543; bh=Awv2Q/kTS4EIeMRM5w7rfLsEcGuf97xy2lh+bykwg30=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=KLNwmustVN5eGr5ZkI+/HO4bQ+3cufL/liGr5otutC/f9mnzhj25zYdshB8Z+txeo woO+s5lCXSoqMHk20Z3mWugmutv/9OMlFJ7GeepZ+4uA8juaBwAtRHmxrlRMwKGt8P 2VAA+BgzaVeC57BG0lVpRYUSYMXNg3TWjBUN+P+M6Q6VDcVDFmeK1XFHKDVcoJNwYj eU3cZg1/03G3zU37nNwus8nym9rbrLAH5J7Wjmq3zn9m6lpYuusG2sYTzDn8Iru2Ex x2el7+KAEGrBXflV2Yd4BMTzt9N3/odyQwFZ7kVzcVd0El0+g1O0iJ27DI0Abfq22D 0STQ8ZmwQj6OA== Date: Thu, 7 Jul 2022 21:25:36 +0100 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Akira Yokosawa , 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: <87ilo8bw3p.fsf@meer.lwn.net> X-Mailer: Claws Mail 4.1.0 (GTK 3.24.34; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Em Thu, 07 Jul 2022 12:45:14 -0600 Jonathan Corbet escreveu: > Akira Yokosawa 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