From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by sourceware.org (Postfix) with ESMTPS id 3EB0F3848419; Fri, 4 Jun 2021 07:27:07 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 3EB0F3848419 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.cz Received: from imap.suse.de (imap-alt.suse-dmz.suse.de [192.168.254.47]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id D43082190C; Fri, 4 Jun 2021 07:27:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1622791625; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vCh4TdiN3LVR2TypQDH67bDbSDaJqdR5+2i+UEa+W1o=; b=XcWutt9YlhHSMaDLHiKTl1pDUwC+Hii1Wyuv/8p8bWSIGbenBjrgEziesknC0gpKwNQYd0 jUbBudoLtBaopcTOB6cM4XTf+Zw9ob/GSqx0Od5fC+LwwvN1udcKlXtDTFUj8zHkBlYxLv q/iEsKHE1rs5DVi3JxBt4RiXBAjvNvs= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1622791625; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vCh4TdiN3LVR2TypQDH67bDbSDaJqdR5+2i+UEa+W1o=; b=ciRex3ZPXsdMFcJgAngscwf6L1djzzRcrTUdMpXJtTD/m3UEoDmbwqBRLwaB5pb7a+1EMb W148cUVV5fNhVzDQ== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id A368B118DD; Fri, 4 Jun 2021 07:27:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1622791625; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vCh4TdiN3LVR2TypQDH67bDbSDaJqdR5+2i+UEa+W1o=; b=XcWutt9YlhHSMaDLHiKTl1pDUwC+Hii1Wyuv/8p8bWSIGbenBjrgEziesknC0gpKwNQYd0 jUbBudoLtBaopcTOB6cM4XTf+Zw9ob/GSqx0Od5fC+LwwvN1udcKlXtDTFUj8zHkBlYxLv q/iEsKHE1rs5DVi3JxBt4RiXBAjvNvs= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1622791625; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vCh4TdiN3LVR2TypQDH67bDbSDaJqdR5+2i+UEa+W1o=; b=ciRex3ZPXsdMFcJgAngscwf6L1djzzRcrTUdMpXJtTD/m3UEoDmbwqBRLwaB5pb7a+1EMb W148cUVV5fNhVzDQ== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id n4iPJsnVuWDzOgAALh3uQQ (envelope-from ); Fri, 04 Jun 2021 07:27:05 +0000 Subject: Re: GCC documentation: porting to Sphinx To: Joseph Myers Cc: Joel Sherrill , GCC Development , gcc-patches@gcc.gnu.org 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> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: Date: Fri, 4 Jun 2021 09:27:05 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.10.2 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, KAM_SHORT, NICE_REPLY_A, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org 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: Fri, 04 Jun 2021 07:27:17 -0000 On 6/3/21 7:16 PM, Joseph Myers wrote: > 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). Sure, that makes sense. > > 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). Yeah, I used the f-string syntax only at one place and it does not pay off. > Formally 3.5 and older are no longer supported > upstream, but certainly still present in some maintained long-term-support > distribution versions. Makes sense. > >> 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"). > I checked that and the template needs at least version 1.6: https://sphinx-rtd-theme.readthedocs.io/en/latest/installing.html#compatibility so I added needs_sphinx to baseconf.py: https://www.sphinx-doc.org/en/master/usage/configuration.html?highlight=conf.py#confval-needs_sphinx The following message is displayed when one builds a manual: $ make html sphinx-build -b "html" -d _build/doctrees . "_build/html" Running Sphinx v4.0.2 Sphinx version error: This project needs at least Sphinx v66.6 and therefore cannot be built with this version. make: *** [Makefile:96: html] Error 2 Martin