From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from fx304.security-mail.net (smtpout30.security-mail.net [85.31.212.34]) by sourceware.org (Postfix) with ESMTPS id 50A173858C2D for ; Wed, 19 Oct 2022 08:14:05 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 50A173858C2D Authentication-Results: sourceware.org; dmarc=fail (p=quarantine dis=none) header.from=kalrayinc.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=kalray.eu Received: from localhost (localhost [127.0.0.1]) by fx304.security-mail.net (Postfix) with ESMTP id F07D99D026 for ; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kalrayinc.com; s=sec-sig-email; t=1666167244; bh=2f+r2/L8hIOrp0R6J/Mnr+aDixl42T7289cu/Hv5P2E=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=QIrW4wX0fqLOBayUB/yFQEpEH7KJfLf/J5otcv4lYqTKI1lwjRXOgTIh9U2g9VU1/ xIXXnB/XUzgX25+P8INqq0wFlFdHOSgTffM7BmXXegS3UpVNw9Ov9QlM+Z6hSdZ7aU IW/BbKq0QnOsV8eO0flETAMyLNlSkcP17ndaKu3c= Received: from fx304 (localhost [127.0.0.1]) by fx304.security-mail.net (Postfix) with ESMTP id D746C9CFFF; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) Received: from zimbra2.kalray.eu (unknown [217.181.231.53]) by fx304.security-mail.net (Postfix) with ESMTPS id 6EE779CF13; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) Received: from zimbra2.kalray.eu (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTPS id 49D3627E0473; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTP id 309E827E0478; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) Received: from zimbra2.kalray.eu ([127.0.0.1]) by localhost (zimbra2.kalray.eu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id QXSwvgV4uFsI; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) Received: from localhost (unknown [192.168.37.51]) by zimbra2.kalray.eu (Postfix) with ESMTPSA id 1062B27E0473; Wed, 19 Oct 2022 10:14:03 +0200 (CEST) X-Virus-Scanned: E-securemail Secumail-id: <16e4f.634fb1cb.6db2e.0> DKIM-Filter: OpenDKIM Filter v2.10.3 zimbra2.kalray.eu 309E827E0478 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kalrayinc.com; s=4F334102-7B72-11EB-A74E-42D0B9747555; t=1666167243; bh=krevKxk8u4CJAonDx37fi7MMPnWL59IKo23BUFfzWvM=; h=Date:From:To:Message-ID:MIME-Version; b=4NYWI94M56AJxRTml/OeSNWjmx9DT2tbmuukWMH9twSEwua3C5Qgrd6jVbbOlKSpt 5fY1RNOiNPbAUyn1quZKeep07ohtDnsqznnzXDsp8dWSYNbPBAD8ToGU/pXuPNebDM T5UphqGLJ1SydI+2ZcPXt6rjeXhxwXChpSCNmbBX1gbvcos5FgdCjzdsM0ReDjEjDf 2AgpV19hHPdD8wc/6aDL0Nn9tDBSXu2NspFUKr/DT8DJhw80p0bdAufzq2VFCPo+NN Cnh2FpPg6gU79l1VYzd++WlK/M3F3qSHCEjPjRrbIdtFGny1hjIcBpBonga+Ho7MU8 W0pMyg9pbYMBQ== Date: Wed, 19 Oct 2022 10:13:55 +0200 From: Paul Iannetta To: Martin =?utf-8?b?TGnFoWth?= Cc: GCC Patches , GCC Development , Sandra Loosemore , "Joseph S. Myers" Subject: Re: Announcement: Porting the Docs to Sphinx - 9. November 2022 Message-ID: <20221019081355.mha6ztlc57rraljr@ws2202.lin.mbt.kalray.eu> References: <9975b774-46d7-8870-fd92-498f5ec50ab4@suse.cz> <9ea57a95-fefe-81a3-848e-ede0893f5b61@suse.cz> <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> <20221017141610.zaoysaggompepcij@ws2202.lin.mbt.kalray.eu> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: User-Agent: NeoMutt/20171215 Content-Transfer-Encoding: 8bit X-ALTERMIMEV2_out: done X-Spam-Status: No, score=-4.7 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,KAM_EU,KAM_SHORT,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On Wed, Oct 19, 2022 at 09:24:06AM +0200, Martin Liška wrote: > On 10/17/22 16:16, Paul Iannetta wrote: > > Hi Martin, > > > > Thank you very much for porting the documentation to Sphinx, it is > > very convenient to use, especially the menu on the left and the > > search bar. > > Thanks, I also like it! > > > > > However, I also regularly browse and search the documentation through > > info, especially when I want to use regexps to search or need to > > include a special character (eg.,+,-,_,(; this can happen when I > > search for '(define' ) for example) in the search string. > > > > Does the port to Sphinx means the end of texinfo? Or, will both be > > available as it is the case now with the official texinfo and your > > unofficial splichal.eu pages. > > It will be still available same as now where manual pages and info pages > are built if you compile GCC from sources. We haven't been publishing manual > pages and info pages on our web pages, people typically get these from > their distribution packages. As long as it is possible to build the info manual with "make info", even through something like rst2texinfo, I would be happy. Would it be possible to see the rst source of the port so as to try rst2texinfo on it? > > Does it help? Or do you expect any change regarding what we publish at: > https://gcc.gnu.org/onlinedocs/ > ? Currently, there is a tarball with texinfo sources for all the manuals for each version. Thanks, Paul > > Cheers, > Martin > > > > > Paul > > > > On Mon, Oct 17, 2022 at 03:28:34PM +0200, Martin Liška wrote: > >> Hello. > >> > >> Based on the very positive feedback I was given at the Cauldron Sphinx Documentation BoF, > >> I'm planning migrating the documentation on 9th November. There are still some minor comments > >> from Sandra when it comes to the PDF output, but we can address that once the conversion is done. > >> > >> The reason I'm sending the email now is that I was waiting for latest Sphinx release (5.3.0) that > >> simplifies reference format for options and results in much simpler Option summary section ([1]) > >> > >> The current GCC master (using Sphinx 5.3.0) converted docs can be seen here: > >> https://splichal.eu/scripts/sphinx/ > >> > >> If you see any issues with the converted documentation, or have a feedback about it, > >> please reply to this email. > >> > >> Cheers, > >> Martin > >> > >> [1] https://github.com/sphinx-doc/sphinx/pull/10840 > >> [1] https://splichal.eu/scripts/sphinx/gcc/_build/html/gcc-command-options/option-summary.html > >> > >> > >> > >> > > > > > > > > > > > > >