From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id ILxkD7pHtGWmmgAAqHPOHw:P1 (envelope-from ) for ; Sat, 27 Jan 2024 01:00:58 +0100 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id ILxkD7pHtGWmmgAAqHPOHw (envelope-from ) for ; Sat, 27 Jan 2024 01:00:58 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b="cdXSf70/"; 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=pass ("zohomail.com:s=zohoarc:i=1") ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1706313658; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=8CD0IHsNfPJU9TIngUx5niRPmipwNSMpRSGBm7tPsBU=; b=Mth6I1YOJ2obkDofP1qbsqWwGsBRiDkDBWsgptyLFrtVWrO/4wFuivoEFXCygAKSxIiUid GklbHPb1axhm539ShNsL3xVbidj+elfu/pEBJd6GUUxAQ8XM2bJ3Xo4nyC4xuoC/bE3in+ g+26jWL5Wi3UWMO/1QGNKIKiXW0POBl8uaUgGKc9V/dWwEOK8ijdS6hZNe7CiPmg4R5Ay6 C3MDjTAXH3+Wi7lBrt6FRJQRGlxFg2O4J/GHjnTVR3jv7RAkjf6V1316a3BCVovt605SM3 FVcQcr32QScWE+VzV3jD9ByO/3YrREG3xPn4McDPlmOZxCGk6PUU2++Xb8uOxQ== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b="cdXSf70/"; 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=pass ("zohomail.com:s=zohoarc:i=1") ARC-Seal: i=2; s=key1; d=yhetil.org; t=1706313658; a=rsa-sha256; cv=pass; b=uTBx4iMpEx4VqiY2G43GoWM//b4Tykm4Wn6o2xDrgbnfJtOkyiIryLyAB2geZZ2FYqrvfy wmddqrDEfiOKcz5tdJUreYfNxou9GjJ8T44pROkrj9fy26uL9UYOGdpUyynQqSY3dLSvLG JerSbr9y+cuBFatD4ssgt4/1HuD9MiBV26M7LW0SSE9o0OMTBU0Rnt+YJwc2iP1BNfbOfF qlxb4bmG07X0oojUfb/CdTYqcfI7Ns93C3zMaOIh3V450VtCQbpTKMNvFO72LU3EWyiHwS It2PHDKYrOIjh7eGfIdv7MutlxszieMTe74Jxf26KtBogKZ63hAVOU42udNC1A== 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 ED3FE42012 for ; Sat, 27 Jan 2024 01:00:57 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rTW7O-0004We-1b; Fri, 26 Jan 2024 19:00:19 -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 1rTW7I-0004TZ-81 for guix-devel@gnu.org; Fri, 26 Jan 2024 19:00:14 -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 1rTW7F-0006LG-ST for guix-devel@gnu.org; Fri, 26 Jan 2024 19:00:11 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1706313595; cv=none; d=zohomail.com; s=zohoarc; b=jh5xL/ZecMIUW4KomE5UD+7PuyuthWnq5HQalPf6NbM8q3C2FmwmON527bK5eljFFwwaMvFQGQaIDoYj8aEk0wOfSnNcGOXm5Y9OXO5fiiIXpt7Q+c6q61LQis9h/uPQsZ1xctg+7OMCVutaoi2/qU0fR8wMm+KX1qiDdzsC8dw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1706313595; h=Content-Type:Cc:Cc:Date:Date:From:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:Subject:To:To:Message-Id:Reply-To; bh=8CD0IHsNfPJU9TIngUx5niRPmipwNSMpRSGBm7tPsBU=; b=AFsm/26vG1T0Q1XUcScdAI0gIt1suN8Y3Ovn89ki0jcBX7LHDLyn0mt3oSCx5P4K7ZaaWG99iLkTUh/wK3yC3ecj47w9aQlaPfYbzFjAFxDTCZVh/70bWLfxN/w7NiaMajeEgZ5GNob7fECKkjGB3jm+eZFVAU0MMrudy6pQhCw= 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=1706313595; s=zmail; d=excalamus.com; i=matt@excalamus.com; h=Date:Date:From:From:To:To:Cc:Cc:Message-Id:Message-Id:In-Reply-To:References:Subject:Subject:MIME-Version:Content-Type:Reply-To; bh=8CD0IHsNfPJU9TIngUx5niRPmipwNSMpRSGBm7tPsBU=; b=cdXSf70/XFE5Qd1HpUENqL59FjPyLSHBLDsPneApzR22wCDPx9QVFw2ye2ygHkJb gkX6ezB3bpNHMcIapaG1oGVSBqyHo/5haGmKQNS+yhmVDzZAdBx3w1BWU60hEO3+FJs Sz1M7a0iDyndQfPzXjEgelfbwp4OPGJjlTQmEZNw= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 170631359319551.392688745661076; Fri, 26 Jan 2024 15:59:53 -0800 (PST) Date: Sat, 27 Jan 2024 00:59:53 +0100 From: Matt To: "Matt" Cc: "Maxim Cournoyer" , "Christian Miller" , "guix-devel" Message-Id: <18d48373140.10c55a4722276191.1969374822318990762@excalamus.com> In-Reply-To: <18d23870de2.119d4f41c239950.5543896370981537109@excalamus.com> References: <87a5p8yn4p.fsf@dadoes.de> <18d0e410102.e16898001715108.8020629039859398477@excalamus.com> <878r4ml93e.fsf@gmail.com> <18d23870de2.119d4f41c239950.5543896370981537109@excalamus.com> Subject: Re: Feedback of the GNU Guix manual MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_7356698_98677223.1706313593153" Importance: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail X-Zoho-Virus-Status: 1 X-Zoho-AV-Stamp: zmail-av-1.1.0/206.284.36 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-Spam-Score: -9.20 X-Migadu-Scanner: mx13.migadu.com X-Spam-Score: -9.20 X-Migadu-Queue-Id: ED3FE42012 X-TUID: WNxCaXWUthpQ ------=_Part_7356698_98677223.1706313593153 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Friendly bump. Attached is a suggested diff. A previous suggestion was made to change "system" to the proper noun "System", as in the "Guix System", within the Binary Installation section. The change would occur in a warning that moving unpacked binary tarballs as directed on existing Guix installations will overwrite system files. The suggested capitalization would be improper since the "system" referred to is "an arbitrary system" and not specifically the Guix System. The broader context is that the change suggested occurs within the Binary Installation section. Since, there is no apparent reason why a user of an existing Guix installation would need to perform a binary installation, this patch removes the warning sentence (containing the confusing usage of "system") and moves it to the beginning of the section so that readers may understand the risk at the start and to decide whether this section applies to them before reading further. The change also corrects the overly broad term "arbitrary system" to the specific "Linux or Hurd-based system." Guix does not work with BSD, Haiku, Windows, or Darwin systems. While installing Guix on these systems may be possible, by some definitions of "install", doing so for an end-user would be silly, since it wouldn't function as expected. The change also more accurately lists the requirements. Previously, it was stated that only tar and Xz are required. This is false since Guix requires a Linux or Hurd-based system. The explanation of "a self-contained tarball providing binaries for Guix and for all its dependencies" was reduced to the simpler "archived binaries." Generally, "tarball" is imprecise, hence the need to explain what it contains in this context. Further, it's jargon, may not be familiar to some readers, and isn't relevant to the point of the introduction, that Guix may be installed without needing to compile and why that might be desirable. Specific mention of installing Guix's dependencies was removed. Guix being installed implies that its dependencies are also installed. The warning line was added in commit: https://git.savannah.gnu.org/cgit/guix.git/commit/?id=5dc3ce5f6c7990f44143f8e9bb9a873a014a82e4. The warning orginates from this commit: https://git.savannah.gnu.org/cgit/guix.git/commit/?id=09722b11e5e618028051d5f6d14eb13529dc7100 I see no associated issue referenced in the commits. I assume the warning is simply being cautious. #+begin_src diff diff --git a/doc/guix.texi b/doc/guix.texi index 4af830aed7..16349d4ec1 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -732,14 +732,16 @@ ready to use it. @cindex installing Guix from binaries @cindex installer script -This section describes how to install Guix on an arbitrary system from a -self-contained tarball providing binaries for Guix and for all its -dependencies. This is often quicker than installing from source, which -is described in the next sections. The only requirement is to have -GNU@tie{}tar and Xz. +This section describes how to install Guix from archived binaries. Such +installations are often quicker than building from source, which is +described in the next sections. Binary installations require a Linux or +Hurd-based system with GNU@tie{}tar and Xz. + +@quotation Important +This section only applies to systems without Guix. Following it for +existing Guix installations will overwrite important system files. @c Note duplicated from the ``Installation'' node. -@quotation Note We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script}. The script automates the download, installation, and #+end_src ------=_Part_7356698_98677223.1706313593153 Content-Type: application/octet-stream; name=0001-binary-installation.diff Content-Transfer-Encoding: 7bit X-ZM_AttachId: 139256063931530110 Content-Disposition: attachment; filename=0001-binary-installation.diff diff --git a/doc/guix.texi b/doc/guix.texi index 4af830aed7..16349d4ec1 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -732,14 +732,16 @@ ready to use it. @cindex installing Guix from binaries @cindex installer script -This section describes how to install Guix on an arbitrary system from a -self-contained tarball providing binaries for Guix and for all its -dependencies. This is often quicker than installing from source, which -is described in the next sections. The only requirement is to have -GNU@tie{}tar and Xz. +This section describes how to install Guix from archived binaries. Such +installations are often quicker than building from source, which is +described in the next sections. Binary installations require a Linux or +Hurd-based system with GNU@tie{}tar and Xz. + +@quotation Important +This section only applies to systems without Guix. Following it for +existing Guix installations will overwrite important system files. @c Note duplicated from the ``Installation'' node. -@quotation Note We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script}. The script automates the download, installation, and ------=_Part_7356698_98677223.1706313593153--