From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id +ND6LEEeHmZ/RQEAqHPOHw:P1 (envelope-from ) for ; Tue, 16 Apr 2024 08:44:17 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id +ND6LEEeHmZ/RQEAqHPOHw (envelope-from ) for ; Tue, 16 Apr 2024 08:44:17 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=pelzflorian.de header.s=key2 header.b="ZzPYS/Kg"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1713249857; a=rsa-sha256; cv=none; b=hIL2Q7h2O7gAcOvEoqEd4wYjVTwgQmXux7VCMIz/FthuMjOSEJB1a2jKkwIoEMKvqmFBy+ /nqOoSU+tT8tV0tPGxYIY18JNmDZBVVtsFwI2rcvurxAMpm+8al+tMFlDAZNz3XmoW88H2 MlEzxK3F4ogxCvha+i7XUu1PIADil2x0tW7+D+B2t8HATWX1ZvEwX6m0i5LMY4h28mIg+j 0dzu1n+QD2w33CVTZ/JqKyQThRFw0ikvClhSkkg8gN4v87jGcx833ll3Qu+Xb78vR5erAX lKGwcVEFTib0CWpiPIuKQVVPKVRDlPySHV4AlaKpPd29/IjlMYnwpXrmAVVDbw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=pelzflorian.de header.s=key2 header.b="ZzPYS/Kg"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1713249857; h=from:from:sender:sender:reply-to:subject:subject: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:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=r836kzvhvvMIx5J1t0Y0HhqbvdrbK/gk3pcDdAs1GgQ=; b=QXc01D+cZf/ycTKGsr4e15B+zK5gLCeenz5EbNkfJlhXomw9zFbzzPShPP4RMibrzXAzEa hD8r/sxzmZ+tf2PnKx0aec9W/ClYOr9ohm6PX2g47SWeZHnst53IIt1aVKYZgkufnNyR9W 0/UEfQO62nsjeh1LVfb0MLY6HDp9T8yTK5BsnvWnkShc6HVhcpTzsu4yT3F3M/T9mXW7LT MzuLiF92MHQwKg6NuIgoSy9bXvYcMfIH2pBOjvJIPP4wqDj7eiGcXqNH7alkqdFzc/yD5H XFWa1PZEmGMfKT3tSxFp5KRpYgb9CslH368U2GkBgdz50Jg1bV4db444NUyWSg== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 9418375BC6 for ; Tue, 16 Apr 2024 08:44:16 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rwcXi-0002IK-Jc; Tue, 16 Apr 2024 02:43:46 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rwcXd-0002EU-Dk for guix-devel@gnu.org; Tue, 16 Apr 2024 02:43:43 -0400 Received: from relay.yourmailgateway.de ([188.68.63.166]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rwcXa-0006xj-Pn; Tue, 16 Apr 2024 02:43:41 -0400 Received: from mors-relay-8202.netcup.net (localhost [127.0.0.1]) by mors-relay-8202.netcup.net (Postfix) with ESMTPS id 4VJZHn63Cwz3y4N; Tue, 16 Apr 2024 08:43:33 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1713249813; bh=21V4k1Plf1vqAuKTLcflmdc+c9nkWwO5l5hGhsUyQN8=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=ZzPYS/Kgs31qA+bx0lMpFqXUk8aEVKbDthEOYyUSqq8PzeCuXXaOUCHAxnGFE0Uh2 TEZvPrahQLksnBcXQCIeP6U+hoDiPeQth4btnLM9ppQOgSOiaE8fmI6CbsF2u8fmmB RFsqF7V3ER4g+ckoo1hcTOVgO/wUObRwVUmRni8WhRHgJd4BUoH1HYH/wpQPfxe0Qg ZTrjlaXjomCYh2rjZuz2mRQ0alKaFmOFogWNOCv3p5pmz++a3sVt1Mn3QKi1HyumNu u3OvpjvVSyp3wiUaohG5MLQreD7AcinQk33XseG1TKfi+kKwtIOo2hVJgi+nSFFM+C PZFsmcLAOhtKw== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by mors-relay-8202.netcup.net (Postfix) with ESMTPS id 4VJZHn5LFgz3xxj; Tue, 16 Apr 2024 08:43:33 +0200 (CEST) Received: from mxe217.netcup.net (unknown [10.243.12.53]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by policy02-mors.netcup.net (Postfix) with ESMTPS id 4VJZHn2CK5z8sgw; Tue, 16 Apr 2024 08:43:33 +0200 (CEST) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id EB840819CD; Tue, 16 Apr 2024 08:43:24 +0200 (CEST) From: "pelzflorian (Florian Pelz)" To: Matt Cc: =?utf-8?Q?Ludovic_Court=C3=A8s?= , "guix-devel" , "maximcournoyer" , "dev" Subject: Re: Fix grammar and markup (was Re: Feedback of the GNU Guix manual) In-Reply-To: <18ee30e6e46.c116b28f999166.8565039911793036545@excalamus.com> (matt@excalamus.com's message of "Mon, 15 Apr 2024 20:39:17 +0200") References: <87a5p8yn4p.fsf@dadoes.de> <18ec853a933.df0e6c395339428.1434045801453734872@excalamus.com> <87il0m49qw.fsf@gnu.org> <18ed68d6b94.f9d1ef36556415.1918708820162605634@excalamus.com> <87wmp17bbk.fsf@pelzflorian.de> <18edd168cf4.10e67baca651980.4372719025458551567@excalamus.com> <87le5evl2t.fsf@pelzflorian.de> <18ee30e6e46.c116b28f999166.8565039911793036545@excalamus.com> Date: Tue, 16 Apr 2024 08:43:23 +0200 Message-ID: <87h6g1u7sk.fsf@pelzflorian.de> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: EB840819CD X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: m7EkWyEWL8ZQYqemTYKxxhstfoiq9cwZnehnUuVsrlKxEKUlzIYkRjaZ Received-SPF: pass client-ip=188.68.63.166; envelope-from=pelzflorian@pelzflorian.de; helo=relay.yourmailgateway.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: guix-devel-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Spam-Score: -6.92 X-Migadu-Queue-Id: 9418375BC6 X-Migadu-Spam-Score: -6.92 X-Migadu-Scanner: mx10.migadu.com X-TUID: Y6wI+/Xrg1zw Hi Matt. When triple checking, I read in =E2=80=9Cinfo "(texinfo)@pxref"= =E2=80=9D: In past versions of Texinfo, it was not allowed to write punctuation after a '@pxref', so it could be used _only_ before a right parenthesis. This is no longer the case. The effect of '@pxref{NODE-NAME}' is similar to that of 'see @ref{NODE-NAME}'. However, in many circumstance the latter is preferrable, as this makes it clear in the Info output that the word "see" should be present. Because of this last sentence, my tendency would now be to use @pxref only for parentheses. (Texinfo is really confusing.) Should I just cut these changes: (Linux Services): Use @pxref to start phrase. (Configuring the Shell): Use @pxref to start phrase. or is there more that should go in this patch? Matt writes: > ---- On Mon, 15 Apr 2024 14:58:50 +0200 pelzflorian (Florian Pelz) wro= te ---=20 > > I believe the Emacs errors are historical; looking at Emacs 29.3 as > > packaged in Guix, Emacs-Info displays xref properly as See. Display > > errors had existed, but in the past only. > > I reported it to emacs-devel (it's addressed now) and the issue isn't > technically @xrefs; it's the compilation of @xref and @ref, '*Note' > and '*note' respectively. Emacs looks at the context around these and > renders them as 'See' or 'see' according to what's nearby. [=E2=80=A6] Ohh thank you and them for the fix. Regards, Florian