From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.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 eFcNKGMSG2Z2HgEA62LTzQ:P1 (envelope-from ) for ; Sun, 14 Apr 2024 01:16:51 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id eFcNKGMSG2Z2HgEA62LTzQ (envelope-from ) for ; Sun, 14 Apr 2024 01:16:51 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=none ("invalid DKIM record") header.d=dadoes.de header.s=default header.b=aMqN6Rea; 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=1713050211; a=rsa-sha256; cv=none; b=aElb/BCNv9xpJfwESLgJDUFZgDS78WOmqbI1b9L8NjutELdJ/3ZnkvESmQfcN4g0aAOoho Dc2RyDXgGknGie/Of5sTJLcLKTY/4rSfVYruJQbN/6kaNlMF4+lORflbiMun/jYTK1YZNt Czp0j6sWWTBUxJyg1Ufw5baID3CyetlIiICmYGoSf9QP2It5JIGky33eBQ8/ITtNIixlcT oGI2PM914OHeFsCfMM65Olm5hgGRqzUm/Smi2/u8LC8zJ33WSTKFDl+AG9hLdMh4F4GXeP VlrG82XLwUXJjSsEWWlDOxe6zVhZhO3qHAE7RKwbdn+wkn0jwu1FtRNEzT/KqQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none ("invalid DKIM record") header.d=dadoes.de header.s=default header.b=aMqN6Rea; 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=1713050211; 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=UaY3bXtxtO8X0Wgsx2UAWur6/TdXkPZe4nAUxL8cb1c=; b=X8OW3b7NsiM+4JQGxBRtaKaa5fv1rG1o/ouRHXw8u+fzi+NwijoA483BCSWL6U4ZVb9FZt IXoLtrpu3Cb5lim2IxIpq2j1aT+2VtAlxaOCDJFl4ZbEQtkkafvXdUBv6tfhHLrVdwCfD9 IC/M/zlfX54iqrzWIBy8Zi2NfTXAy9hqUAtFWht3EigxwC+mEQvyZYhvBy44kPb4u9XYly CrpiQ30IB2mcHeOnXFA6WW7LaJtPSAp4l1MgMc+0heeiTWsMUZ2CqAXDTrL8CrkSTMceNu a94F1BFZjFPLYRaaquJHtEBGsXznnSpMnuabOXtEjCgv/0UGTM1/YBhhKqq+NQ== 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 71296764B3 for ; Sun, 14 Apr 2024 01:16:51 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rvmbi-0001mN-S8; Sat, 13 Apr 2024 19:16:27 -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 1ruu7B-0005DI-Il for guix-devel@gnu.org; Thu, 11 Apr 2024 09:05:17 -0400 Received: from mail.dadoes.de ([159.69.132.198]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ruu74-0001AI-GD for guix-devel@gnu.org; Thu, 11 Apr 2024 09:05:17 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=dadoes.de; s=default; t=1712840345; bh=+Yt0rVr2+LCHdJuvTI7MQfNMW9HW6IynZagoU69li7g=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=aMqN6Reap7DZMnN+/7442vNs8n0eSrqxEOjy3171WWknyNxKmjylkS7ynoS0GFrNy rNt7wF+W8rqHf2AcalPzkrUQqFjD+eIV6QQgc3HIWLcuCURMOu8M0MxwQRQL3ijQSx XgM6rM2Hu6j0EGzHFQNuV6r7FwPPupIz6G/lhfhJxJPZcbmkDLBVzC/JoYU+WCzCYf OGTIbgVwfrsEX/UJ1Yweb7lofhE1H218RQEQGf4STYwuNMljx454Vf8BMOcLTQ63oZ nBSODkhSIFydUIFHsjTm86S4mmUVfcIiQzsPAvmGtGGketKazmgtke4ZwaDxSR0EQq f5xZ6Aw1OaRF8LOJT5iNNDZIeYXNEl2Afbe8L41ng3RGZtmrfubmOQ8vKQOo20rk6L fk4c4ashn9vJdPNup5IaXth8VEfL1TLCTqc2IJlYVbsz1MnvMlmQ3oK5YvhZT2RsCU ZjnpNZypRDOEVzSGZDlo9x2edR3l1umK9ftmqLYTqqQQqji8F7HPFBpKeDYD+crP07 yhdUZry22kQdnaNn/CdhPeRhTq1m4HZnEHGI9mSRX9KSBUAdy8dmmVoFqPSSw8EUQx w9O2ArZwWlty0pQPQ+RESogMaIegXYQMMhLa5cd8WMa6WoQdDoMuj0TrJQNjvALX38 0oYDHa3vcUHO7VrNm+cVEFKQ= Received: from [10.10.10.2] (unknown [10.10.10.2]) by mail.dadoes.de (Postfix) with ESMTPSA id 99AAF8471B; Thu, 11 Apr 2024 14:59:05 +0200 (CEST) Message-ID: Date: Thu, 11 Apr 2024 14:59:03 +0200 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: Fix grammar and markup (was Re: Feedback of the GNU Guix manual) To: Matt , guix-devel Cc: Christian Miller , pelzflorian , maximcournoyer , dev References: <87a5p8yn4p.fsf@dadoes.de> <18ec853a933.df0e6c395339428.1434045801453734872@excalamus.com> From: Christian Miller In-Reply-To: <18ec853a933.df0e6c395339428.1434045801453734872@excalamus.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Received-SPF: none client-ip=159.69.132.198; envelope-from=christian.miller@mail.dadoes.de; helo=mail.dadoes.de X-Spam_score_int: -19 X-Spam_score: -2.0 X-Spam_bar: -- X-Spam_report: (-2.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, SPF_NONE=0.001, T_SPF_HELO_TEMPERROR=0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sat, 13 Apr 2024 19:16:24 -0400 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: -3.87 X-Migadu-Queue-Id: 71296764B3 X-Migadu-Spam-Score: -3.87 X-Migadu-Scanner: mx10.migadu.com X-TUID: ewBNh9ZUPQ89 Hello, I just want to mention that I am still in CC and my mail server is going offline. Need to optimize my budget and don't have any time for GNU anymore because of university. -- Christian Miller Am 10/04/2024 um 16:05 schrieb Matt: > We're working through a list of feedback one item at a time: > https://lists.gnu.org/archive/html/guix-devel/2024-01/msg00117.html > > We have completed the first two items. > > The next item reported is: > > #+begin_quote > 2.4 Setting up the deamon > > Seems like an issue with info. Have seen this in the Emacs manual as well. There is also sometimes see see (doc) > > L15 See also see Substitutes. > #+end_quote > > This sounds like the use of an @xref instead of @ref. However, I can't find it in the current version (5a95cf76) of the documentation, nor the reported version (ee7c9d25). The last change to doc/guix.texi at that the reported time was in e5ed1712 (git log -n 1 ee7c9d25 -- doc/guix.texi). > > The full reported sentence currently reads, > > #+begin_quote > See also @ref{Substitutes}, for information on how to allow the daemon to download pre-built binaries. > #+end_quote > > The use of the comma after "Substitutes" is inappropriate, if I have the terminology correct, because "See also Substitutes" is not a participial phrase. "Also" and "information on" are also unnecessary. I suggest the following: > > #+begin_quote > See @ref{Substitutes} for how to allow the daemon to download pre-built binaries. > #+end_quote > > Searching for "see also" turns up the following in 'Mail Services': > > #+begin_quote > See also ssl=required setting. > #+end_quote > > This needs "the" before "ssl=required" as it refers to a specific setting. It should probably use the @option or @samp markup: > > #+begin_quote > See also the @samp{ssl=required} setting. > #+end_quote > > I have opted for @samp because it's used elsewhere for similar items. In the same section is: > > #+begin_quote > NOTE: See also @samp{disable-plaintext-auth} setting. > #+end_quote > > This too should have "the" before the setting. The "NOTE:" designation is also unnecessary. I suggest: > > #+begin_quote > See also the @samp{disable-plaintext-auth} setting. > #+end_quote > > Included is a patch which makes these suggested changes. > > It was advised to submit the previous patch to guix-patches. I opted to submit this next patch here to keep the thread connected since it's part of a larger discussion (I suppose). If we're agreed that guix-patches is more appropriate, I can submit the next item in a new thread there using the same message format I've been following. Thoughts?