From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa3.mentor.iphmx.com (esa3.mentor.iphmx.com [68.232.137.180]) by sourceware.org (Postfix) with ESMTPS id EB74C3857C75; Thu, 3 Jun 2021 17:16:25 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org EB74C3857C75 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com IronPort-SDR: Qx0WyQ6ktIB9lqdgna6GkzLwhsjcPoGRFlku0MiAGACv/oRPuRSQ6ElF/6/cdzcUXMUq0TyabT G9Ypbo7OvEYKERH2FO1zKI/4k/sBOv/OIeHdJJnKtDtI3K8yCbGSIN80jAIH3kUWP1azFt0Mvr lZZhkTrxPjcQ/OaSTpqvZO1F4PA1+8eZsKl1Hga1eVp45dSqgxM5k9FcP+zwy7JPbKCUUcutF6 mJVt/odNX6Hb8D53RLon32XRchdc88pMSW5Ste+RIBdBs7NKlkfSGJnTEkPlmlsMbyBOjpRmXv BjI= X-IronPort-AV: E=Sophos;i="5.83,246,1616486400"; d="scan'208";a="61972018" Received: from orw-gwy-02-in.mentorg.com ([192.94.38.167]) by esa3.mentor.iphmx.com with ESMTP; 03 Jun 2021 09:16:25 -0800 IronPort-SDR: LGe0PD/3qXJ/WEYLellFjfhH2B2YVA0PULL9GOEOOzdB3BzF5aKF2bcQ5SuDs4Ewm+Io5Yypae YKjmzYpfoVw/4noLphCYuAP0k3RlFk9+/snoigP1SqK6dAkfwGUj9xMDoElR+PJzroPttfVK9S N6WlqgKrb81SjZtIYtpkZSfg76nl+DI5OADV4mWrG40bklmw1eE05+ifgFjNBqnuObWBk1/yIu AtbwWseGwYlDPqUaXAdX1VGmFeYQOPMeuHwHPfw9njuCtJ1sbko2Miyo0T+3PSDMAkm2GTkTtq Bsw= Date: Thu, 3 Jun 2021 17:16:18 +0000 From: Joseph Myers X-X-Sender: jsm28@digraph.polyomino.org.uk To: =?ISO-8859-15?Q?Martin_Li=A8ka?= CC: Joel Sherrill , GCC Development , Subject: Re: GCC documentation: porting to Sphinx In-Reply-To: <08e6fd33-75f1-9449-571c-c31fe64284a1@suse.cz> Message-ID: References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> <08e6fd33-75f1-9449-571c-c31fe64284a1@suse.cz> User-Agent: Alpine 2.22 (DEB 394 2020-01-19) MIME-Version: 1.0 X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: SVR-IES-MBX-07.mgc.mentorg.com (139.181.222.7) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-Spam-Status: No, score=-3120.9 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, KAM_SHORT, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=no autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8BIT X-Content-Filtered-By: Mailman/MimeDel 2.1.29 X-BeenThere: gcc@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Jun 2021 17:16:27 -0000 On Thu, 3 Jun 2021, Martin Liška wrote: > On 6/2/21 6:44 PM, Joseph Myers wrote: > > On Wed, 2 Jun 2021, Joel Sherrill wrote: > > > > > For RTEMS, we switched from texinfo to Sphinx and the dependency > > > on Python3 for Sphinx has caused a bit of hassle. Is this going to be > > > an issue for GCC? > > > > What Sphinx (and, thus, Python) versions does the GCC manual build work > > with? > > I've just tried version 1.7.6 which we use for libgccjit and it's fine: > https://gcc.gnu.org/onlinedocs/jit/ > > About Python version: I'm not planning supporting Python2, it's dead 10 years > already. There should be appropriate configure checks to avoid building manuals with too-old versions (i.e. disable the info/man manual build/install when Sphinx, or the Python version it's using, is too old or missing, not fail configure). Actually this code is depending on Python 3.6 or later because of the use of an f-string in baseconf.py (without that f-string, it works with older versions, even 2.7). Formally 3.5 and older are no longer supported upstream, but certainly still present in some maintained long-term-support distribution versions. > I would recommend testing the build. You can simply clone: > https://github.com/marxin/texi2rst-generated > > and simply run 'make html' or 'make latexpdf'. Basic dependencies are > mentioned here: > https://github.com/marxin/texi2rst-generated#requirements It appears "make html" works (with lots of WARNINGs) with Sphinx 1.6.1 but fails with 1.4 ("Theme error: unsupported theme option 'prev_next_buttons_location' given"). -- Joseph S. Myers joseph@codesourcery.com