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 ms8.migadu.com with LMTPS id CM6XFFDjqmVmtAAAqHPOHw:P1 (envelope-from ) for ; Fri, 19 Jan 2024 22:02:08 +0100 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 CM6XFFDjqmVmtAAAqHPOHw (envelope-from ) for ; Fri, 19 Jan 2024 22:02:08 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=UkOhmCv9; arc=pass ("zohomail.com:s=zohoarc:i=1"); 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=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1705698128; 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=mJtLdxhWcicTYlAa23q0W1wbxZAoeEkBdzADirIDRNM=; b=s0pyWNaJeMzTJyIKCPMzIl+rLJgHKyDVBq46QN9yQ+/ugXxSQ+OBaOFWxz/yIFUJY1Wzu7 8h2xTjobIAoU533HCWBWHhm61vsp9nxHhcXwyivOY1n76tdoxiFQrhge5KRwcCu7m5qlof Yyc0or2FTmWot1yfTKJytA5EOgckcKYaZ9tEde4P9VOQ0XfDdLSLZ49LahWjyb21md5osG ALhVf/P6rBgrQERb4fIST6lQgcuRpVu2v6yXPkd9lFO4ae5XzjKqI6hS2qS1PEgMNRr7lX ehiaMNZMrEpVsbnAPr7ekvCIML6LPz/WuRR2oFchgtOWMdILvBSSpCGtGhAWMw== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1705698128; a=rsa-sha256; cv=pass; b=XF2nKu/DqKUn1N9swKBAy0rkrZ7mTXkluTx/6fCGm4EcwTEdtBxtCB0vjf7sA8gSBFRijc 6R7O4otdTiKYGlSZDrNxxM3D+IVgYoODDGpcWwj2lntW29mQ/gnMSawDNi8idvF96g2klF CC6FF7HoyEAyJl4aVtJbgaPYKtIdWDco2Q/Id8w/FyagUAGWF6ZTHPZ05au0q9sLZj//QC A1YIbsuscdtIMo3Hswnr+6bYXQqwCCZCbgfRqsxlVAkF7FOWP+Kiftqhwk1a1/1xY3y8ir 2GmcrwGytiPNAVA5/Cp7KLrJUgm1WwIP6NKvH/eXxP/T7czi4+KOYD/uZ8pkxQ== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=UkOhmCv9; arc=pass ("zohomail.com:s=zohoarc:i=1"); 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" 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 09C8821205 for ; Fri, 19 Jan 2024 22:02:08 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rQvzR-0001K1-03; Fri, 19 Jan 2024 16:01:25 -0500 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 1rQvzP-0001Jn-Sq for guix-devel@gnu.org; Fri, 19 Jan 2024 16:01:23 -0500 Received: from sender4-op-o10.zoho.com ([136.143.188.10]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rQvzN-0005Oj-NB for guix-devel@gnu.org; Fri, 19 Jan 2024 16:01:23 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1705698071; cv=none; d=zohomail.com; s=zohoarc; b=nAslA+6extup2PJ/NS0xj6ikObKkn1AYf/YjVb+4+HO3iziS/Lo+KKC0g+iXeLm/w2bF0Q+PGnhh2p9GM7kIt30/smO4OoGtRKYgKy0/DR7NAtpXWtaymCAzZeAt+alpo/3/Fa3gEf4R4gnIhIv0HjbLgf7oRbgsXaQq3YLwByM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1705698071; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:Subject:To:To:Message-Id:Reply-To; bh=mJtLdxhWcicTYlAa23q0W1wbxZAoeEkBdzADirIDRNM=; b=COLTm4PLRxxhl/QPkvS7q7p7T8W+l7YIfFARt/8IokIC4nRFjDS8X/WRC+qn/LAEtmqKoEE6Fsudf0LBTotBk70xwh6Ka8TofP8+k4FFsj4CTRexYUyY3JQgmtSzQVkDZkcyqVgVc9XKZOnxbLqQyowXGHmXNS+I4yEIXf7FKMQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=excalamus.com; spf=pass smtp.mailfrom=matt@excalamus.com; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1705698071; s=zmail; d=excalamus.com; i=matt@excalamus.com; h=Date:Date:From:From:To:To:Cc:Cc:Message-ID:In-Reply-To:References:Subject:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Message-Id:Reply-To; bh=mJtLdxhWcicTYlAa23q0W1wbxZAoeEkBdzADirIDRNM=; b=UkOhmCv9IZ5i4t6YbL3fNZM2bGP59QGrifrewPnIIYxvTKGW4rlkqqIeACsxn5mO ypIdSWIstg5w3rDdBEB9UBnmc32a0wgPrWkhhDX3IhUVSHusnU0/tTW7ndDeUad6pMC V6W1TnsXUZ0dBt8hQU6HxLuAYBUj5B+pLnu1/q/Q= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 17056980700061011.207122723119; Fri, 19 Jan 2024 13:01:10 -0800 (PST) Date: Fri, 19 Jan 2024 22:01:09 +0100 From: Matt To: "Maxim Cournoyer" Cc: "Christian Miller" , "guix-devel" Message-ID: <18d23870de2.119d4f41c239950.5543896370981537109@excalamus.com> In-Reply-To: <878r4ml93e.fsf@gmail.com> References: <87a5p8yn4p.fsf@dadoes.de> <18d0e410102.e16898001715108.8020629039859398477@excalamus.com> <878r4ml93e.fsf@gmail.com> Subject: Re: Feedback of the GNU Guix manual MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Importance: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail Received-SPF: pass client-ip=136.143.188.10; envelope-from=matt@excalamus.com; helo=sender4-op-o10.zoho.com 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, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -10.72 X-Spam-Score: -10.72 X-Migadu-Queue-Id: 09C8821205 X-TUID: QjJ1WLtUSWAr ---- On Thu, 18 Jan 2024 20:44:53 +0100 Maxim Cournoyer wrote ---=20 > That would be a good way to help, yes! It'll be easier to review if > each distinct problem is fixed in its own commit (patch). Now that I've looked more closely at it, I completely agree. I suggest we take them point-by-point and move on only after we've complete= d each one in turn.=20 ** Binary installation L73 Guix system should be Guix System *** Comment Line 73 in the info file, section "Binary Installation" corresponds to line 825 in =3Ddoc/guix.texi=3D. =3D15efd5a7f4:doc/guix.texi=3D reads, #+begin_quote Do _not_ unpack the tarball on a working Guix system since that would overwrite its own essential files. #+end_quote I see several issues with this sentence. In order of severity: 1. the sentence isn't necessary 2. the problem is moving, not unpacking 3. the sentence confuses the subject 4. (reported) the word "system" is unclear At this point in the manual, the reader has downloaded a Guix tarball and has just been instructed to unpack and move the extracted files. The sentence warns that moving =3D/tmp/var/guix=3D to =3D/var/=3D and =3D/tmp/gnu=3D to =3D/=3D will overwrite files already there from an existi= ng Guix installation. **** 1. the sentence isn't necessary Is there ever a circumstance where a Guix installation, from a binary or as a System, would need to install Guix from the tarball? Unless there's a reason for a Guix user to follow the steps in "Binary Installation," I suggest we remove this sentence and revise the introduction paragraph to make sure current Guix users skip this section. -- Matt Trzcinski Emacs Org contributor (ob-shell) Learn more about Org mode at https://orgmode.org Support Org development at=C2=A0https://liberapay.com/org-mode