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 701A03846024; Wed, 30 Jun 2021 13:28:42 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 701A03846024 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 5164E21C6B; Wed, 30 Jun 2021 13:28:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1625059721; 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=MNJhPVRnfmi6whFMTOOQ2S2qRY2FPeW7MhA2rajpZGE=; b=LTmdo2DEDh4ulEgMF/JmflFh7Ph/9HqAS+5+6zkCrWkLzmJMhKb/8LWnlHHS7CMaJquFWm QzZPokhoRrnHUkmUF1zdyjQVNxLRzScHp225z01gPChEoHtkIMJCN5S/GrjrgqqGj6amQX J1MKuJOtZp7TCSRwiWeJD8YB+FRgGfU= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1625059721; 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=MNJhPVRnfmi6whFMTOOQ2S2qRY2FPeW7MhA2rajpZGE=; b=fLNL/GzXQnHbAr2AtvF9CtqY++xv2HYzkSSbXFgwYf5KXtbzifwtdaPrhho7KQFtajw7Sc +AzlB0BPCUugQYAQ== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id 2A259118DD; Wed, 30 Jun 2021 13:28:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1625059721; 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=MNJhPVRnfmi6whFMTOOQ2S2qRY2FPeW7MhA2rajpZGE=; b=LTmdo2DEDh4ulEgMF/JmflFh7Ph/9HqAS+5+6zkCrWkLzmJMhKb/8LWnlHHS7CMaJquFWm QzZPokhoRrnHUkmUF1zdyjQVNxLRzScHp225z01gPChEoHtkIMJCN5S/GrjrgqqGj6amQX J1MKuJOtZp7TCSRwiWeJD8YB+FRgGfU= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1625059721; 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=MNJhPVRnfmi6whFMTOOQ2S2qRY2FPeW7MhA2rajpZGE=; b=fLNL/GzXQnHbAr2AtvF9CtqY++xv2HYzkSSbXFgwYf5KXtbzifwtdaPrhho7KQFtajw7Sc +AzlB0BPCUugQYAQ== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id hnVGCYlx3GDWcwAALh3uQQ (envelope-from ); Wed, 30 Jun 2021 13:28:41 +0000 Subject: Re: [PATCH] Port GCC documentation to Sphinx To: Eli Zaretskii Cc: joseph@codesourcery.com, gcc@gcc.gnu.org, 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> <83a6n8obh4.fsf@gnu.org> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: Date: Wed, 30 Jun 2021 15:28:40 +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: <83a6n8obh4.fsf@gnu.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, 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: Wed, 30 Jun 2021 13:28:45 -0000 On 6/29/21 6:57 PM, Eli Zaretskii wrote: > 2. The translation of @var produces double-quoting in Info, here's an > example: > > The usual way to run GCC is to run the executable called ‘gcc’, or > ‘`machine'-gcc’ when cross-compiling, or ‘`machine'-gcc-`version'’ to > run a specific version of GCC. > > vs, the old > > The usual way to run GCC is to run the executable called 'gcc', or > 'MACHINE-gcc' when cross-compiling, or 'MACHINE-gcc-VERSION' to run a > specific version of GCC. > > I think the new variant is less readable and more confusing, because > it isn't clear whether the quotes are part of the text. Here's an > extreme example: > > ‘@`file'’ > > Read command-line options from ‘`file'’. The options read are > inserted in place of the original ‘@`file'’ option. If ‘`file'’ > does not exist, or cannot be read, then the option will be treated > literally, and not removed. For this one, I've just created the following pull request: https://github.com/sphinx-doc/sphinx/pull/9391 Cheers, Martin