From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from fx405.security-mail.net (smtpout140.security-mail.net [85.31.212.145]) by sourceware.org (Postfix) with ESMTPS id CC2AC3858D32 for ; Mon, 17 Oct 2022 14:16:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org CC2AC3858D32 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 (fx405.security-mail.net [127.0.0.1]) by fx405.security-mail.net (Postfix) with ESMTP id 7D3B5337BA0 for ; Mon, 17 Oct 2022 16:16:22 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kalrayinc.com; s=sec-sig-email; t=1666016182; bh=KrTJSUuZLSo8ksPGavT72xYU6ZI3l6rVXS+VjKcibjw=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=W1Ys+HqpD6qLLPXhFI6aUzqyjPLTO7C78ea91oL52G5uMBliABm1akasXXmpppEII tRtfXv/zXXvzJb9s8JhMXhnjqUGJVO2M2+6aUavrT37t0r+Eh9to24qdS76wKd9Gie RtMIFLHq5k65On876D7x1j4cqv2FPbIE783LsivM= Received: from fx405 (fx405.security-mail.net [127.0.0.1]) by fx405.security-mail.net (Postfix) with ESMTP id 28F46337B79; Mon, 17 Oct 2022 16:16:22 +0200 (CEST) Received: from zimbra2.kalray.eu (unknown [217.181.231.53]) by fx405.security-mail.net (Postfix) with ESMTPS id 2924C337B85; Mon, 17 Oct 2022 16:16:19 +0200 (CEST) Received: from zimbra2.kalray.eu (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTPS id F2D0927E0454; Mon, 17 Oct 2022 16:16:18 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTP id D5F8027E045B; Mon, 17 Oct 2022 16:16:18 +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 MiOnSvb1JTgp; Mon, 17 Oct 2022 16:16:18 +0200 (CEST) Received: from localhost (unknown [192.168.37.51]) by zimbra2.kalray.eu (Postfix) with ESMTPSA id B6DD327E0454; Mon, 17 Oct 2022 16:16:18 +0200 (CEST) X-Virus-Scanned: E-securemail Secumail-id: <36f6.634d63b3.25ef1.0> DKIM-Filter: OpenDKIM Filter v2.10.3 zimbra2.kalray.eu D5F8027E045B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kalrayinc.com; s=4F334102-7B72-11EB-A74E-42D0B9747555; t=1666016178; bh=3iV0BMN/hGmOtcXrq6Kcu9wFu/p/mGcEgctfCXUFhEo=; h=Date:From:To:Message-ID:MIME-Version; b=sW+58ckAf0mwSwiGr0iN5SPg/z61iFChIhikmAFVYADrSn/FVymBvEePWwTrFEGce eeokSn7Gq1jSCLQFmLFVAooAuox6CY7Qe8CZYtkkD51S3uv0Q/Q192wsNf+10+G2Bm rPlGg8YmLMNVotpo9cm6W1KHNDBMrW4+S0zi3p2wFDmJuvBJeRIJoXKMuoppY2ue8j /Z8dn45k7B1FDlpdqhyxQSN8sLAtMNS35wATxzdytAcCMqOap5hotJwcVDmuT+5Qi5 CWEWzvGIPQrpXcURamx1x8SbrwkoRabP+no/GIIo5zGwicHcf01neWSZ6eAoO2yu8m qnX2zKCjXF9kA== Date: Mon, 17 Oct 2022 16:16:10 +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: <20221017141610.zaoysaggompepcij@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> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> User-Agent: NeoMutt/20171215 Content-Transfer-Encoding: 8bit X-ALTERMIMEV2_out: done X-Spam-Status: No, score=-3.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,KAM_EU,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: 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. 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. 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 > > > >