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 81625385AC35; Wed, 30 Jun 2021 11:58:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 81625385AC35 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 3C638226EA; Wed, 30 Jun 2021 11:58:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1625054295; 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=qDgkrIXJuiBvKubbT7JSryWihenJn/l/U2XUjMINBpg=; b=qX889S2RdE8soOFz82iwbzQN/AsGfcyDsodepqf+MgKq/L8IITofHUvuFHsADtN/NKma/o N0uDQFiLDCGhQOqZCLu/c9xs1xaJMR2SMH/FVFsk8uR7HibKXJYLSNEJEdAqtH4RYPYWMf ANJ5/YrbVu+ukOLwYYkRjdO5YPMVfOs= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1625054295; 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=qDgkrIXJuiBvKubbT7JSryWihenJn/l/U2XUjMINBpg=; b=OqrLL2zPK5+L8a018RmrzMDEX2FMrO6ypIMCEuO704jYN67JrCvicq0wBc1GIT/mVvyU7w 0SSschyIYX+QFZBQ== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id 1430B118DD; Wed, 30 Jun 2021 11:58:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1625054295; 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=qDgkrIXJuiBvKubbT7JSryWihenJn/l/U2XUjMINBpg=; b=qX889S2RdE8soOFz82iwbzQN/AsGfcyDsodepqf+MgKq/L8IITofHUvuFHsADtN/NKma/o N0uDQFiLDCGhQOqZCLu/c9xs1xaJMR2SMH/FVFsk8uR7HibKXJYLSNEJEdAqtH4RYPYWMf ANJ5/YrbVu+ukOLwYYkRjdO5YPMVfOs= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1625054295; 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=qDgkrIXJuiBvKubbT7JSryWihenJn/l/U2XUjMINBpg=; b=OqrLL2zPK5+L8a018RmrzMDEX2FMrO6ypIMCEuO704jYN67JrCvicq0wBc1GIT/mVvyU7w 0SSschyIYX+QFZBQ== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id Fhv6Aldc3GBzQAAALh3uQQ (envelope-from ); Wed, 30 Jun 2021 11:58:15 +0000 Subject: Re: [PATCH] Port GCC documentation to Sphinx To: Richard Earnshaw , 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> <869ac2f3-7866-dc0f-7464-daf90bc5c816@foss.arm.com> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: <85b1cfb0-48ec-d180-c7e0-849e34aa08af@suse.cz> Date: Wed, 30 Jun 2021 13:58:14 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.11.0 MIME-Version: 1.0 In-Reply-To: <869ac2f3-7866-dc0f-7464-daf90bc5c816@foss.arm.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, KAM_EU, NICE_REPLY_A, SPF_HELO_NONE, 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 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 11:58:17 -0000 On 6/30/21 12:14 PM, Richard Earnshaw wrote: > > > 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". Sure, fixed (while preserving the filename, we have multi copies of it). Martin > > https://grammarist.com/usage/indexes-indices/ > > R.