From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id kI4rEC1sGmagsgAAe85BDQ:P1 (envelope-from ) for ; Sat, 13 Apr 2024 13:27:41 +0200 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id kI4rEC1sGmagsgAAe85BDQ (envelope-from ) for ; Sat, 13 Apr 2024 13:27:41 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=pelzflorian.de header.s=key2 header.b="Yu4VDf/g"; 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"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1713007661; 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=VHomTz9mbx6R5zRKj/BqVU0uG5Y2Fpfhg1NeJhReaXw=; b=LG9DX5/ymAp3BajQ3X2Ve8YlD4p9xUnYcdGLtKskzyyH7nYvnGa3F/uJECJF0I1ekK9mf+ 0t/qdFg2oSJytsTbY/hCQCE0Kg/nLB+Recdt7FyiKf9jPlKsGMISIPZRwHi2SI5NuzCPEr 8TqJ1xGbqU16d7r2OKX8VyDPnP1F5LyebU4D5iUqqvsc9Q312ZIy7epvlchlbBuwA99uZF E5MD3XZVO6vc+IbzWMxvDmXtpUbCSZ0DkQL3Om3PLCdLYC39RBL3JmR23FAZ+gPmTGh6Bq /Q3yTvPyccYEZ2+wHP8wjpzMji96PNmTHKmuu1AeGP4o/ogGQn83gxfrNvksnQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1713007661; a=rsa-sha256; cv=none; b=gHZKuzcSlNBOoQtTL7CIrMt5nF15JbnwYqeX52hx/NgTmZHi3uzCUIYvXiFdWKaKxXWkC9 RNF/I0KqGAcHwZrj7i93L5P9ucvfeoHU/fvzsxWIbSUxh0hFVn4FY07eWUKFYoj2lcb1de 5w936/yDHeLfE1Nqu4Ng8Dz4Z7r5UtjnjHtNm4Mk5PKB0fyjgrDxpd/zqCaKQRpvOnU/iF PiC9VGuQZcn3VFxPxGTwx3t9QwLMcWrszYDr/opmjF2CozpLoHbyKk+OeK1iHcCsYQWQx5 B2JE2CFFnXBziUdAdUB6o51/uJ0ZrQo4Vnhv13UkKQFleCLNhTCKmV1IZoF+ww== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=pelzflorian.de header.s=key2 header.b="Yu4VDf/g"; 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"; dmarc=none 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 15C4B195EB for ; Sat, 13 Apr 2024 13:27:40 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rvbXB-000724-B5; Sat, 13 Apr 2024 07:27:01 -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 1rvbXA-00071u-8A for guix-devel@gnu.org; Sat, 13 Apr 2024 07:27:00 -0400 Received: from relay.yourmailgateway.de ([194.59.206.189]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rvbX4-0000Ez-EI; Sat, 13 Apr 2024 07:26:59 -0400 Received: from relay02-mors.netcup.net (localhost [127.0.0.1]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4VGrk23439z42pD; Sat, 13 Apr 2024 13:26:50 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=pelzflorian.de; s=key2; t=1713007610; bh=1oj9Y2s8VubK/UfdZP361Eg5E6wiOzTsw0EzE1NsdIM=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=Yu4VDf/gnnluZFAw03PPyl45agqCNmC2NPiB0WFU0SetjHAWJOsItbFWGq/k9jqdC 4OgTMOg3QLtG2E06+nO306J7WhbZKwIP6IELnQGqwGTs1i5hRZVCrDB1t7b5DzdsNe lsurTA9P5SAJz7Y3S8za+UX6+0fgYJwGpwp3m4fXmH29w8uqWAcx8sae2k9wPv2+Gw n9i+wQhm+AIC3FgbCFYpe1sv80z/ERCzdTu1Qb+6DYaAetjICh/ZO3PWPqGT9Khcks vd5blbnYN1AsGnh+/LmovY4ro4D9jbG/5qgqperx0QZKws6nWN1wrl+LNcOFwL1q17 NBvWZwQb0a1Cw== Received: from policy02-mors.netcup.net (unknown [46.38.225.35]) by relay02-mors.netcup.net (Postfix) with ESMTPS id 4VGrk22gDTz7xqq; Sat, 13 Apr 2024 13:26:50 +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 4VGrk203QNz8sgW; Sat, 13 Apr 2024 13:26:49 +0200 (CEST) Received: from florianrock64 (ip92344de0.dynamic.kabel-deutschland.de [146.52.77.224]) by mxe217.netcup.net (Postfix) with ESMTPSA id 8D2B28365E; Sat, 13 Apr 2024 13:26:41 +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: <18ed68d6b94.f9d1ef36556415.1918708820162605634@excalamus.com> (matt@excalamus.com's message of "Sat, 13 Apr 2024 10:22:56 +0200") References: <87a5p8yn4p.fsf@dadoes.de> <18ec853a933.df0e6c395339428.1434045801453734872@excalamus.com> <87il0m49qw.fsf@gnu.org> <18ed68d6b94.f9d1ef36556415.1918708820162605634@excalamus.com> Date: Sat, 13 Apr 2024 13:26:39 +0200 Message-ID: <87wmp17bbk.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: 8D2B28365E X-Rspamd-Server: rspamd-worker-8404 X-NC-CID: VuJY1o4dVO4ngtVlE7wofkFXkU1J5+p4BemCeTX6gEqWvY9Kn+BbBU3n Received-SPF: pass client-ip=194.59.206.189; 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, 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-Migadu-Spam-Score: -7.80 X-Spam-Score: -7.80 X-Migadu-Queue-Id: 15C4B195EB X-Migadu-Scanner: mx12.migadu.com X-TUID: L6BVDJ06k0yt Hello Matt. Thank you for fixing the oversight. However: Matt writes: > From: Matthew Trzcinski > Date: Sat, 13 Apr 2024 10:12:05 +0200 > Subject: [PATCH] doc: Fix cross-references > > * doc/guix.texi (Setting Up the Daemon): use @xref to start sentence. > (Build Systems): capitalize "python" and start parenthesized reference wi= th > @pxref. > (Linux Services): use @xref to start phrase. @xref produces a capital See instead of see. This should be @pxref. See the Texinfo manual =E2=80=9Cinfo texinfo=E2=80=9D or the Web manual Lud= o points to. In info, this will use the word *note instead of *see, but it=E2=80=99s sti= ll right, if Matt you agree. > (Configuring the Shell): use @xref to start phrase. This should be @pxref. Additionally, the commit message=E2=80=99s first sentence should end with a period. The sentences in the commit message describing a section should start with a capital letter. Regards, Florian