From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm1-x32e.google.com (mail-wm1-x32e.google.com [IPv6:2a00:1450:4864:20::32e]) by sourceware.org (Postfix) with ESMTPS id 8B1513858D1E for ; Sun, 12 Mar 2023 08:12:33 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8B1513858D1E Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-wm1-x32e.google.com with SMTP id d41-20020a05600c4c2900b003e9e066550fso5941000wmp.4 for ; Sun, 12 Mar 2023 00:12:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1678608752; h=content-transfer-encoding:mime-version:message-id:references :in-reply-to:subject:to:from:date:from:to:cc:subject:date:message-id :reply-to; bh=GC5LwEZtXM+7X7K6t+B4sET+kg1yFbxVkG2P6SNPo4s=; b=nShVE4XzL64lt+2Vtz1Q6iS1X7/YtoGaAuhMAbgqqIIVNkab9w9WQ0u/qZbhr/xyrR sPnlrdkM236Eaj5frrQrtx9qqt2h+19ark5lvnF93KuS6lLEoGUMWJYep5RNbPVjJ9DT SiEyc0Uz4bW9IG/Tc/W/jOdudet52aJwewSwWdQhdgKlbiM9vqICcuK2liDRIkAiQuTf BrLGHhom1Vor46eJTwBzPSSDv/IL2b9F4ezeaJ0v8vDDBYGoWf9xh0ZkqNtOgJTF8GB3 3z6FeMpe/w6tlgU+LD611PFgkd9kqyI6bisdTqTW2ws0fHIp1PKMIPlZFiXd7F63UwzA C2zw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1678608752; h=content-transfer-encoding:mime-version:message-id:references :in-reply-to:subject:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=GC5LwEZtXM+7X7K6t+B4sET+kg1yFbxVkG2P6SNPo4s=; b=ayN1AJBRuss8EtniUyYrdBLwulgyV0IkaBCTGzzLeS8Gnb9FLzC6GnnZNbVcVq6j1G ycFTcxX0t+JG8Azo6s/YLiDV1WHX9034MFOPliaKX9G6wKvoO/JUMy/55fKcHAmQ57kW rbm5+64LrB9EMtLSAmjEvFfe/i2N1JSQ6P+Eb8MI+jEzqXcV4mfNVlQ6Ax4nzWHuRkq+ zxF4fxDHkxC0p1NFjKthaps6vG3qsZFfFwgYT2rdErbZ7aQIjMI46vmv9j8GhoFHmmvU qVBwqdUZCA35mBwalW8P1P2cQDbug/0WIcXbcyLaBKraCbWINsQi0Ddw9VJcTFzUd8D/ uHjg== X-Gm-Message-State: AO0yUKUONVyWLnGH24tVQexdrdu034lACsFanGan+AkH2x+8elvUbx8y G4MhZTL+aniT85es98lECNM= X-Google-Smtp-Source: AK7set/uIjJPxJYr4xkzzpOHu3YAVPFzPYQLvC5Hx5fjMhsOlnoN543olcPuoknx7j7uhtjV+fpPAg== X-Received: by 2002:a05:600c:a04:b0:3eb:3971:a2aa with SMTP id z4-20020a05600c0a0400b003eb3971a2aamr7515313wmp.25.1678608752056; Sun, 12 Mar 2023 00:12:32 -0800 (PST) Received: from ?IPv6:::1? ([2001:871:227:1e16:10bb:72c9:e8a4:fc91]) by smtp.gmail.com with ESMTPSA id iz20-20020a05600c555400b003ed201ddef2sm1364626wmb.2.2023.03.12.00.12.31 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 12 Mar 2023 00:12:31 -0800 (PST) Date: Sun, 12 Mar 2023 09:12:27 +0100 From: Bernhard Reutner-Fischer To: Sean Bright , Sean Bright via Gcc-patches Subject: Re: [PATCH] docs: Fix double 'See' in zero-length-bounds docs. In-Reply-To: References: <6D3851AF-0A1B-4E5D-B100-F63900CFFE54@gmail.com> Message-ID: <11A5528F-9B3F-4F35-8CEF-BA2FF28DA3DA@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-10.4 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,GIT_PATCH_0,RCVD_IN_DNSWL_NONE,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: On 12 March 2023 03:47:08 CET, Sean Bright via Gcc-patches wrote: >On 3/11/2023 6:39 PM, Bernhard Reutner-Fischer wrote: >> On 11 March 2023 18:33:46 CET, Sean Bright via Gcc-patches wrote: >>> Hi, >>> >>> This fixes a minor issue where the zero-length-bound docs read "See Se= e >>> Zero Length=2E" >>> >>> gcc/ChangeLog: >>> =C2=A0=C2=A0 =C2=A0* doc/invoke=2Etexi (Warning Options): Remove erran= t 'See' >>> =C2=A0=C2=A0 =C2=A0before @xref=2E >>> --- >>> =C2=A0gcc/doc/invoke=2Etexi | 2 +- >>> =C2=A01 file changed, 1 insertion(+), 1 deletion(-) >>> >>> diff --git a/gcc/doc/invoke=2Etexi b/gcc/doc/invoke=2Etexi >>> index 3a6a97862b0=2E=2E174d160dd6c 100644 >>> --- a/gcc/doc/invoke=2Etexi >>> +++ b/gcc/doc/invoke=2Etexi >>> @@ -8345,7 +8345,7 @@ conversions the warnings @option{-Wno-int-to-poi= nter-cast} and >>> =C2=A0@item -Wzero-length-bounds >>> =C2=A0Warn about accesses to elements of zero-length array members tha= t might >>> =C2=A0overlap other members of the same object=2E=C2=A0 Declaring inte= rior zero-length >>> -arrays is discouraged because accesses to them are undefined=2E=C2=A0= See >>> +arrays is discouraged because accesses to them are undefined=2E >>> =C2=A0@xref{Zero Length}=2E >> >> I'm not a native speaker, but wouldn't it be better to talk about singu= lar access, i=2Ee=2E s/accesses/access/ in both cases? >> >> thanks, > >As a native speaker it does not feel ergonomic to use 'accesses' in this >context but it also does not feel objectively wrong=2E I'm happy to >provide a follow-up patch if you feel strongly about it=2E I'd prefer the singular but defer to the documentation maintainers=2E thanks,