From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by sourceware.org (Postfix) with ESMTP id 2CE29383603D; Wed, 30 Jun 2021 10:14:28 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 2CE29383603D Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id BCF4111D4; Wed, 30 Jun 2021 03:14:27 -0700 (PDT) Received: from [10.57.8.94] (unknown [10.57.8.94]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 9C47E3F5A1; Wed, 30 Jun 2021 03:14:26 -0700 (PDT) Subject: Re: [PATCH] Port GCC documentation to Sphinx To: =?UTF-8?Q?Martin_Li=c5=a1ka?= , Joseph Myers Cc: 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> <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz> <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz> <87489d9a-44e2-411c-3f3a-534d07e78b95@suse.cz> <0866a0ea-c846-ea5e-ac7a-d1c8f106cc45@suse.cz> <5bb9a10d-f3b9-f16a-7430-bbae2d4978e2@suse.cz> <2f60f602-5d88-7674-9620-2172748664c5@suse.cz> <7b524125-db09-19aa-c1f2-ed826562e01e@suse.cz> From: Richard Earnshaw Message-ID: <869ac2f3-7866-dc0f-7464-daf90bc5c816@foss.arm.com> Date: Wed, 30 Jun 2021 11:14:23 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.8.1 MIME-Version: 1.0 In-Reply-To: <7b524125-db09-19aa-c1f2-ed826562e01e@suse.cz> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-GB Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-3491.4 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, KAM_EU, KAM_LAZY_DOMAIN_SECURITY, NICE_REPLY_A, SPF_HELO_NONE, SPF_NONE, 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 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: Wed, 30 Jun 2021 10:14:30 -0000 On 30/06/2021 05:47, Martin Liška wrote: > On 6/29/21 12:50 PM, Richard Earnshaw wrote: >> >> >> On 29/06/2021 11:09, Martin Liška wrote: >>> On 6/28/21 5:33 PM, Joseph Myers wrote: >>>> Are formatted manuals (HTML, PDF, man, info) corresponding to this >>>> patch >>>> version also available for review? >>> >>> I've just uploaded them here: >>> https://splichal.eu/gccsphinx-final/ >>> >>> Martin >>> >> >> In the HTML version of the gcc manual the sidebar has an "Option >> index" link but no link to the general index.  When you follow that >> link the page contents is just a link to the "index" where everything >> is all lumped together. >> >> If we can't have separate indexes for options and general entries, I >> think it would make more sense for the Option index link to be removed >> entirely. > > Fully agree with you. Thanks for the feedback and I've changed that to > the standard Sphinx section, > see e.g. > https://splichal.eu/gccsphinx-final/html/gcc/indices-and-tables.html > > Martin > >> >> R. > Thanks. Given that the manual is nominally in American English, it might be better to use the term "indexes" rather than "indices". https://grammarist.com/usage/indexes-indices/ R.