From unknown Sat Jun 21 05:15:21 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions. Resent-From: Julien Lepiller Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 27 May 2020 15:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 41565 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 41565@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.159059343412632 (code B ref -1); Wed, 27 May 2020 15:31:01 +0000 Received: (at submit) by debbugs.gnu.org; 27 May 2020 15:30:34 +0000 Received: from localhost ([127.0.0.1]:49810 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdy0n-0003Hg-R0 for submit@debbugs.gnu.org; Wed, 27 May 2020 11:30:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:54830) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdy0l-0003HW-Cs for submit@debbugs.gnu.org; Wed, 27 May 2020 11:30:31 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50148) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jdy0l-00023z-6o for guix-patches@gnu.org; Wed, 27 May 2020 11:30:31 -0400 Received: from lepiller.eu ([2a00:5884:8208::1]:38712) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jdy0j-0004ew-CV for guix-patches@gnu.org; Wed, 27 May 2020 11:30:30 -0400 Received: from lepiller.eu (localhost [127.0.0.1]) by lepiller.eu (OpenSMTPD) with ESMTP id 901dcd66 for ; Wed, 27 May 2020 15:30:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=lepiller.eu; h=date:from :to:subject:message-id:mime-version:content-type; s=dkim; bh=T4A eurHFY730cve1u6prug6QbfBWbVON8RQtbwjz7pg=; b=SRsLiaxQPYEuFPUPmh/ f1ZDcH5IMAOJMQBatks3rkLbfoSM/ZQ0GGqQjiuhsIkrY+xGKTKc0/+i5OdYF804 7tYT75OImua1/whsxDBMu1GB1hFMqMJEYpS0aTiQm8BgJ6u16xSSq53igBkuDYz5 9sepmEUmyXmHuKwEOBCtfjl5Vmnf0wS5puLBmmNNIifnqZrs6T5+eWV1sM3RK5Qt Q/lCuNsHJIgBObIAuIut3PIy6+CeSr90Zbb4V1bkXitsqeioSdUPF5niFXGTVDD7 ET0m0NxlEamG81wxs18IRhcTLSZZkodMleUPvYyho039um8Xh9LhnP8S+pa47kmK ZpA== Received: by lepiller.eu (OpenSMTPD) with ESMTPSA id af3ea93e (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for ; Wed, 27 May 2020 15:30:21 +0000 (UTC) Date: Wed, 27 May 2020 17:30:13 +0200 From: Julien Lepiller Message-ID: <20200527173013.36a11a54@tachikoma.lepiller.eu> X-Mailer: Claws Mail 3.17.5 (GTK+ 2.24.32; x86_64-unknown-linux-gnu) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="MP_/UJ50M5TzkZNZGpWyA00xEhj" Received-SPF: none client-ip=2a00:5884:8208::1; envelope-from=julien@lepiller.eu; helo=lepiller.eu X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) --MP_/UJ50M5TzkZNZGpWyA00xEhj Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline Some users seem to be confused by the fact that our URLs in the manual don't work for them. This is most likely because they copy them without reading the rest of the text which clearly says they should replace @var{system} with one of the supported values. One example of this confusion is this conversation: https://mastodon.social/@Nixfreak/104224784493287104 Since our current approach doesn't seem to be very effective, I propose to change the URLs and file names with actual ones, using x86_64-linux as the system because this is the most popular platform that we support nowadays. I keep mentioning the other architectures as alternatives, hoping that users will notice the x86_64 in the URL and keep reading to learn how to install Guix for another architecture if they want to. Wdyt? --MP_/UJ50M5TzkZNZGpWyA00xEhj Content-Type: text/x-patch Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=0001-doc-Use-existing-URLs-and-file-names-in-installation.patch >From 5be064d009e3e45029fe8c5b9a7cc0c8275bec50 Mon Sep 17 00:00:00 2001 From: Julien Lepiller Date: Wed, 27 May 2020 16:52:53 +0200 Subject: [PATCH] doc: Use existing URLs and file names in installation instructions. Some users are confused that these URLs and file names don't work, so change them to the most popular architecture, while still mentioning alternatives. * doc/guix.texi (USB Stick and DVD Installation): Use x86_64-linux URLs by default. --- doc/guix.texi | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 4dbbf96db9..695b0c4485 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -567,17 +567,18 @@ Installing goes along these lines: @item @cindex downloading Guix binary Download the binary tarball from -@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz}, -where @var{system} is @code{x86_64-linux} for an @code{x86_64} machine -already running the kernel Linux, and so on. +@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz}, +where @code{x86_64-linux} can be replaced with @code{xi686-linux} for an +@code{i686} (32-bits) machine already running the kernel Linux, and so on +(@pxref{GNU Distribution}). @c The following is somewhat duplicated in ``System Installation''. Make sure to download the associated @file{.sig} file and to verify the authenticity of the tarball against it, along these lines: @example -$ wget @value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz.sig -$ gpg --verify guix-binary-@value{VERSION}.@var{system}.tar.xz.sig +$ wget @value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig +$ gpg --verify guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig @end example If that command fails because you do not have the required public key, @@ -603,7 +604,7 @@ you may have to run @code{su -} or @code{sudo -i}. As @code{root}, run: @example # cd /tmp # tar --warning=no-timestamp -xf \ - /path/to/guix-binary-@value{VERSION}.@var{system}.tar.xz + /path/to/guix-binary-@value{VERSION}.x86_64-linux.tar.xz # mv var/guix /var/ && mv gnu / @end example @@ -1917,8 +1918,8 @@ about their support in GNU/Linux. An ISO-9660 installation image that can be written to a USB stick or burnt to a DVD can be downloaded from -@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.@var{system}.iso.xz}, -where @var{system} is one of: +@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.xz}, +where you can replace @code{x86_64-linux} with one of: @table @code @item x86_64-linux @@ -1933,8 +1934,8 @@ Make sure to download the associated @file{.sig} file and to verify the authenticity of the image against it, along these lines: @example -$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.@var{system}.iso.xz.sig -$ gpg --verify guix-system-install-@value{VERSION}.@var{system}.iso.xz.sig +$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.xz.sig +$ gpg --verify guix-system-install-@value{VERSION}.x86_64-linux.iso.xz.sig @end example If that command fails because you do not have the required public key, @@ -1965,7 +1966,7 @@ To copy the image to a USB stick, follow these steps: Decompress the image using the @command{xz} command: @example -xz -d guix-system-install-@value{VERSION}.@var{system}.iso.xz +xz -d guix-system-install-@value{VERSION}.x86_64-linux.iso.xz @end example @item @@ -1974,7 +1975,7 @@ its device name. Assuming that the USB stick is known as @file{/dev/sdX}, copy the image with: @example -dd if=guix-system-install-@value{VERSION}.@var{system}.iso of=/dev/sdX +dd if=guix-system-install-@value{VERSION}.x86_64-linux.iso of=/dev/sdX sync @end example @@ -1990,7 +1991,7 @@ To copy the image to a DVD, follow these steps: Decompress the image using the @command{xz} command: @example -xz -d guix-system-install-@value{VERSION}.@var{system}.iso.xz +xz -d guix-system-install-@value{VERSION}.x86_64-linux.iso.xz @end example @item @@ -1999,7 +2000,7 @@ its device name. Assuming that the DVD drive is known as @file{/dev/srX}, copy the image with: @example -growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.@var{system}.iso +growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.x86_64-linux.iso @end example Access to @file{/dev/srX} usually requires root privileges. -- 2.26.2 --MP_/UJ50M5TzkZNZGpWyA00xEhj-- From unknown Sat Jun 21 05:15:21 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions. Resent-From: Tobias Geerinckx-Rice Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 27 May 2020 15:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41565 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Julien Lepiller Cc: 41565@debbugs.gnu.org Received: via spool by 41565-submit@debbugs.gnu.org id=B41565.159059464714538 (code B ref 41565); Wed, 27 May 2020 15:51:02 +0000 Received: (at 41565) by debbugs.gnu.org; 27 May 2020 15:50:47 +0000 Received: from localhost ([127.0.0.1]:49824 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdyKM-0003mQ-Mp for submit@debbugs.gnu.org; Wed, 27 May 2020 11:50:46 -0400 Received: from tobias.gr ([80.241.217.52]:37780) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdyKK-0003mE-5u for 41565@debbugs.gnu.org; Wed, 27 May 2020 11:50:45 -0400 Received: by tobias.gr (OpenSMTPD) with ESMTP id 92112397; Wed, 27 May 2020 15:50:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=tobias.gr; h=from:to:cc :subject:references:in-reply-to:date:message-id:mime-version :content-type; s=2018; i=me@tobias.gr; bh=5wLCUbIhG2K/PhvU1h0c8X CuePKAZW88aeZO4oIliHg=; b=Bj/qn49CJIBKAA1R+anrh3grJZ8tzUeBivDiID MwS+n1X823VKKkDjpqgH8VQENVv6yq7UMUM/MDmSkw1Bdk/8rVc1EnZDZhBQOCYm d8qoK2dljZUXkxO195xee9KZXkqlO2760uWpZ0TbEpWYbqp5g8gNXRueMHyUW3NU pnqIkcitNO0di1GXorugDJcqNLD2AmZtnF/sAva11pY64OfSJVQLdYv3yrZvP7b4 SEgMEVYc7Xq82TkAugADwNYbN6k5rrGA6A/bnopaZZ4gOA8V45t+En9qgYGFV/RD 4RYUPeMXAjR4eR6e9a2lb9P5LsObyxBU50hOnGGPp79Y+7+Q== Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 09838316 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Wed, 27 May 2020 15:50:44 +0000 (UTC) From: Tobias Geerinckx-Rice References: <20200527173013.36a11a54@tachikoma.lepiller.eu> In-reply-to: <20200527173013.36a11a54@tachikoma.lepiller.eu> Date: Wed, 27 May 2020 17:50:41 +0200 Message-ID: <87v9kh4bse.fsf@nckx> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Julien, Julien Lepiller =E5=86=99=E9=81=93=EF=BC=9A > https://mastodon.social/@Nixfreak/104224784493287104 Sigh :-) > Since our current approach doesn't seem to be very effective, I=20 > propose > to change the URLs and file names with actual ones, using=20 > x86_64-linux > as the system because this is the most popular platform that we=20 > support > nowadays. I keep mentioning the other architectures as=20 > alternatives, > hoping that users will notice the x86_64 in the URL and keep=20 > reading to > learn how to install Guix for another architecture if they want=20 > to. I like it! Kind regards, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQT12iAyS4c9C3o4dnINsP+IT1VteQUCXs6MUQAKCRANsP+IT1Vt eTUuAP48O37oIZvwkCN1+ZSgoedbe9+C9QqIXzmjQQQZlVu7/wD/XnZYQ5SsOW8W J9jIWNLYtsljWr9a4LmxN9pUU3hUcQc= =QYN4 -----END PGP SIGNATURE----- --=-=-=-- From unknown Sat Jun 21 05:15:21 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions. Resent-From: Leo Famulari Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 27 May 2020 17:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41565 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Julien Lepiller Cc: 41565@debbugs.gnu.org Received: via spool by 41565-submit@debbugs.gnu.org id=B41565.159059986031269 (code B ref 41565); Wed, 27 May 2020 17:18:02 +0000 Received: (at 41565) by debbugs.gnu.org; 27 May 2020 17:17:40 +0000 Received: from localhost ([127.0.0.1]:49904 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdzgR-00088H-LN for submit@debbugs.gnu.org; Wed, 27 May 2020 13:17:39 -0400 Received: from out5-smtp.messagingengine.com ([66.111.4.29]:56527) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdzgP-000882-Ja for 41565@debbugs.gnu.org; Wed, 27 May 2020 13:17:38 -0400 Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 7FFF05C018A; Wed, 27 May 2020 13:17:32 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute2.internal (MEProxy); Wed, 27 May 2020 13:17:32 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=mesmtp; bh=gyuEE73I6yBXvm65qXuQOUa5 3GYcHcVUgS6OaWzzZo4=; b=W/QV6eFCey2jdiSUp1SpIYM5lTLtlmrdnbeQZE8C GzhHpUN4qn8QiCJmt4ib1UBZ0UEsb0hmN5TQjz+Oc0LUotJbiuTVSTO9iGJsu/Xf /FmDDevrnUFwqURZbOxjzOrolLxC8ISoatCaWhpccmu4A8F4xAAPvo+xw3t3gfPg gDk= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=gyuEE7 3I6yBXvm65qXuQOUa53GYcHcVUgS6OaWzzZo4=; b=Psi2EjeeegiL9w6550XeHp 7x342hvFNNYQj6HnCuxvZqngUA0i055PCjnLBz/lBCHgY0X9p1v6gS02yNdzhCfn wakS04927zFBcjro7Z2wHBsXYHDkBpBAzEC5RO6TjiGIA6jaEY8kLJAtS6jMItjH JeE42QVlwELehUvIeE6XpT+rj6qJ6H4qjC46/y0y0x5PA5wXJjThg+oZyvUgpkJi VzZXRPell1/vGoz7x1XEeIaIbP4O1gim49cbxjb0n2TVIiCa5r+LeoVrW5gyfCJO Ig6zlVqhv8xSJabJqr/U04gs8Rt8Zyw99zXC0Zz2VdjXimXVpWGe5jIyiSTEQjEw == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduhedruddvgedguddttdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpeffhffvuffkfhggtggujgesthdtredttddtvdenucfhrhhomhepnfgvohcu hfgrmhhulhgrrhhiuceolhgvohesfhgrmhhulhgrrhhirdhnrghmvgeqnecuggftrfgrth htvghrnhepfeffkeeuiefhhefhvefgvddvledukeehjeehvedutdfgvedvieejvdffffet ffeinecuffhomhgrihhnpehmrghsthhoughonhdrshhotghirghlnecukfhppeejiedrud dvgedrudefkedrieefnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghi lhhfrhhomheplhgvohesfhgrmhhulhgrrhhirdhnrghmvg X-ME-Proxy: Received: from localhost (c-76-124-138-63.hsd1.pa.comcast.net [76.124.138.63]) by mail.messagingengine.com (Postfix) with ESMTPA id D8898328005D; Wed, 27 May 2020 13:17:31 -0400 (EDT) Date: Wed, 27 May 2020 13:17:30 -0400 From: Leo Famulari Message-ID: <20200527171730.GC28889@jasmine.lan> References: <20200527173013.36a11a54@tachikoma.lepiller.eu> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200527173013.36a11a54@tachikoma.lepiller.eu> X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Wed, May 27, 2020 at 05:30:13PM +0200, Julien Lepiller wrote: > Some users seem to be confused by the fact that our URLs in the manual > don't work for them. This is most likely because they copy them > without reading the rest of the text which clearly says they should > replace @var{system} with one of the supported values. One example of > this confusion is this conversation: > https://mastodon.social/@Nixfreak/104224784493287104 > > Since our current approach doesn't seem to be very effective, I propose > to change the URLs and file names with actual ones, using x86_64-linux > as the system because this is the most popular platform that we support > nowadays. I keep mentioning the other architectures as alternatives, > hoping that users will notice the x86_64 in the URL and keep reading to > learn how to install Guix for another architecture if they want to. I agree, it's a common mistake for new users. Your patch seems like the right thing to do... From unknown Sat Jun 21 05:15:21 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions. Resent-From: Marius Bakke Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 27 May 2020 20:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41565 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Julien Lepiller , 41565@debbugs.gnu.org Received: via spool by 41565-submit@debbugs.gnu.org id=B41565.159061229510400 (code B ref 41565); Wed, 27 May 2020 20:45:02 +0000 Received: (at 41565) by debbugs.gnu.org; 27 May 2020 20:44:55 +0000 Received: from localhost ([127.0.0.1]:50086 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1je2v1-0002hg-3e for submit@debbugs.gnu.org; Wed, 27 May 2020 16:44:55 -0400 Received: from eggs.gnu.org ([209.51.188.92]:56970) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1je2uz-0002hS-LI for 41565@debbugs.gnu.org; Wed, 27 May 2020 16:44:53 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44997) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1je2ut-0003Hh-8t; Wed, 27 May 2020 16:44:47 -0400 Received: from ti0006q161-2604.bb.online.no ([84.202.68.75]:58144 helo=localhost) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1je2us-0002BR-Px; Wed, 27 May 2020 16:44:47 -0400 From: Marius Bakke In-Reply-To: <20200527173013.36a11a54@tachikoma.lepiller.eu> References: <20200527173013.36a11a54@tachikoma.lepiller.eu> Date: Wed, 27 May 2020 22:44:44 +0200 Message-ID: <87tv013y6b.fsf@gnu.org> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) --=-=-= Content-Type: text/plain Julien Lepiller writes: > Wdyt? Sgtm. [...] > -@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz}, > -where @var{system} is @code{x86_64-linux} for an @code{x86_64} machine > -already running the kernel Linux, and so on. > +@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz}, > +where @code{x86_64-linux} can be replaced with @code{xi686-linux} for an ^^^ stray 'x' --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEu7At3yzq9qgNHeZDoqBt8qM6VPoFAl7O0TwACgkQoqBt8qM6 VPoSvAgA1FjNPFjyc/yJo1TqpLae0GfAoy9FIP1+tBtTWUeet9Lgu6INhUX3gZSU EFP9IDQufm9c02IZqk+Pv92f0S8gCTKOS3iDKpF20wqRjY73CPNXKfSm80zinVRD OPtoOy9cvV8jfS09PkYzduWOq3jIvTShu5jS9GmG/wMHH3X1DSWl1s/3J6KsH4bx zJiSgvGC5TnH4DtJdoovuACtiPhEQxI3rUt686KYHLg3MnlG8PGO0JmQlu9MlsJP olZnbQ/i7e3DfCyGaHRiNO8D8vWh9KZExfR+THZ8I+1XVjcWF6ubNOOuk41htAmb hPba2ORvKkdpLkXQR+4uszEdYt64Dw== =aVwV -----END PGP SIGNATURE----- --=-=-=-- From unknown Sat Jun 21 05:15:21 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Julien Lepiller Subject: bug#41565: closed (Re: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions.) Message-ID: References: <20200527232911.74e8c406@tachikoma.lepiller.eu> <20200527173013.36a11a54@tachikoma.lepiller.eu> X-Gnu-PR-Message: they-closed 41565 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: patch Reply-To: 41565@debbugs.gnu.org Date: Wed, 27 May 2020 21:30:04 +0000 Content-Type: multipart/mixed; boundary="----------=_1590615004-23049-1" This is a multi-part message in MIME format... ------------=_1590615004-23049-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #41565: [PATCH] doc: Use existing URLs and file names in installation instr= uctions. which was filed against the guix-patches package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 41565@debbugs.gnu.org. --=20 41565: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D41565 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1590615004-23049-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 41565-done) by debbugs.gnu.org; 27 May 2020 21:29:21 +0000 Received: from localhost ([127.0.0.1]:50160 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1je3c1-0005xN-Lo for submit@debbugs.gnu.org; Wed, 27 May 2020 17:29:21 -0400 Received: from lepiller.eu ([89.234.186.109]:50534) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1je3c0-0005xD-0G for 41565-done@debbugs.gnu.org; Wed, 27 May 2020 17:29:20 -0400 Received: from lepiller.eu (localhost [127.0.0.1]) by lepiller.eu (OpenSMTPD) with ESMTP id ce19a90e for <41565-done@debbugs.gnu.org>; Wed, 27 May 2020 21:29:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=lepiller.eu; h=date:from :to:subject:message-id:in-reply-to:references:mime-version :content-type:content-transfer-encoding; s=dkim; bh=81ztgT2Oe7qC n+KilwGDHwHVHYWjQTDxsvKgmH+lN/0=; b=FzT70SoaTbiPtoX9ls1BG9Gkw4wr ge+So36ZnUiIX/Ns7d8cjZEhOExy4MKJ6fn73Y/jTkWroTMflAJ+Ctne+xOCviKT Te2X0EXaJnG23flbev2CJmEKmKv4koEBeQg7hZOatxSUTrUxGXoimuuwE4Pv3Z5P 1qqGtoqbH+OZ65VimywZRt5PzB+OsyuZjofg90z/BtlDWU/vQUSOwLlCsj4q566O btwWABYSccuzsjnGiqPqT5UXRztDVHadPT7H2KfiZThyo4O7UtsLKG+7K8Drzb3i VYT3l1UP3KjBwlzvntEEbXy0uShQQQIep55QC8HMUlJq2cL5hNlO8nMhUQ== Received: by lepiller.eu (OpenSMTPD) with ESMTPSA id ab0a2125 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for <41565-done@debbugs.gnu.org>; Wed, 27 May 2020 21:29:17 +0000 (UTC) Date: Wed, 27 May 2020 23:29:11 +0200 From: Julien Lepiller To: 41565-done@debbugs.gnu.org Subject: Re: [bug#41565] [PATCH] doc: Use existing URLs and file names in installation instructions. Message-ID: <20200527232911.74e8c406@tachikoma.lepiller.eu> In-Reply-To: <87tv013y6b.fsf@gnu.org> References: <20200527173013.36a11a54@tachikoma.lepiller.eu> <87tv013y6b.fsf@gnu.org> X-Mailer: Claws Mail 3.17.5 (GTK+ 2.24.32; x86_64-unknown-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 41565-done X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Le Wed, 27 May 2020 22:44:44 +0200, Marius Bakke a =C3=A9crit : > Julien Lepiller writes: >=20 > > Wdyt? =20 >=20 > Sgtm. >=20 > [...] >=20 > > -@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}= .tar.xz}, > > -where @var{system} is @code{x86_64-linux} for an @code{x86_64} > > machine -already running the kernel Linux, and so on. > > +@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux= .tar.xz}, > > +where @code{x86_64-linux} can be replaced with @code{xi686-linux} > > for an =20 > ^^^ stray 'x' Pushed as f18d5d75979f5374962c03a8f3c266054a489e11 with this fix, a copyright line for me and an improved commit message. Thank you! ------------=_1590615004-23049-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 27 May 2020 15:30:34 +0000 Received: from localhost ([127.0.0.1]:49810 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdy0n-0003Hg-R0 for submit@debbugs.gnu.org; Wed, 27 May 2020 11:30:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:54830) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jdy0l-0003HW-Cs for submit@debbugs.gnu.org; Wed, 27 May 2020 11:30:31 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50148) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jdy0l-00023z-6o for guix-patches@gnu.org; Wed, 27 May 2020 11:30:31 -0400 Received: from lepiller.eu ([2a00:5884:8208::1]:38712) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jdy0j-0004ew-CV for guix-patches@gnu.org; Wed, 27 May 2020 11:30:30 -0400 Received: from lepiller.eu (localhost [127.0.0.1]) by lepiller.eu (OpenSMTPD) with ESMTP id 901dcd66 for ; Wed, 27 May 2020 15:30:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=lepiller.eu; h=date:from :to:subject:message-id:mime-version:content-type; s=dkim; bh=T4A eurHFY730cve1u6prug6QbfBWbVON8RQtbwjz7pg=; b=SRsLiaxQPYEuFPUPmh/ f1ZDcH5IMAOJMQBatks3rkLbfoSM/ZQ0GGqQjiuhsIkrY+xGKTKc0/+i5OdYF804 7tYT75OImua1/whsxDBMu1GB1hFMqMJEYpS0aTiQm8BgJ6u16xSSq53igBkuDYz5 9sepmEUmyXmHuKwEOBCtfjl5Vmnf0wS5puLBmmNNIifnqZrs6T5+eWV1sM3RK5Qt Q/lCuNsHJIgBObIAuIut3PIy6+CeSr90Zbb4V1bkXitsqeioSdUPF5niFXGTVDD7 ET0m0NxlEamG81wxs18IRhcTLSZZkodMleUPvYyho039um8Xh9LhnP8S+pa47kmK ZpA== Received: by lepiller.eu (OpenSMTPD) with ESMTPSA id af3ea93e (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO) for ; Wed, 27 May 2020 15:30:21 +0000 (UTC) Date: Wed, 27 May 2020 17:30:13 +0200 From: Julien Lepiller To: guix-patches@gnu.org Subject: [PATCH] doc: Use existing URLs and file names in installation instructions. Message-ID: <20200527173013.36a11a54@tachikoma.lepiller.eu> X-Mailer: Claws Mail 3.17.5 (GTK+ 2.24.32; x86_64-unknown-linux-gnu) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="MP_/UJ50M5TzkZNZGpWyA00xEhj" Received-SPF: none client-ip=2a00:5884:8208::1; envelope-from=julien@lepiller.eu; helo=lepiller.eu X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) --MP_/UJ50M5TzkZNZGpWyA00xEhj Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline Some users seem to be confused by the fact that our URLs in the manual don't work for them. This is most likely because they copy them without reading the rest of the text which clearly says they should replace @var{system} with one of the supported values. One example of this confusion is this conversation: https://mastodon.social/@Nixfreak/104224784493287104 Since our current approach doesn't seem to be very effective, I propose to change the URLs and file names with actual ones, using x86_64-linux as the system because this is the most popular platform that we support nowadays. I keep mentioning the other architectures as alternatives, hoping that users will notice the x86_64 in the URL and keep reading to learn how to install Guix for another architecture if they want to. Wdyt? --MP_/UJ50M5TzkZNZGpWyA00xEhj Content-Type: text/x-patch Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=0001-doc-Use-existing-URLs-and-file-names-in-installation.patch >From 5be064d009e3e45029fe8c5b9a7cc0c8275bec50 Mon Sep 17 00:00:00 2001 From: Julien Lepiller Date: Wed, 27 May 2020 16:52:53 +0200 Subject: [PATCH] doc: Use existing URLs and file names in installation instructions. Some users are confused that these URLs and file names don't work, so change them to the most popular architecture, while still mentioning alternatives. * doc/guix.texi (USB Stick and DVD Installation): Use x86_64-linux URLs by default. --- doc/guix.texi | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 4dbbf96db9..695b0c4485 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -567,17 +567,18 @@ Installing goes along these lines: @item @cindex downloading Guix binary Download the binary tarball from -@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz}, -where @var{system} is @code{x86_64-linux} for an @code{x86_64} machine -already running the kernel Linux, and so on. +@indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz}, +where @code{x86_64-linux} can be replaced with @code{xi686-linux} for an +@code{i686} (32-bits) machine already running the kernel Linux, and so on +(@pxref{GNU Distribution}). @c The following is somewhat duplicated in ``System Installation''. Make sure to download the associated @file{.sig} file and to verify the authenticity of the tarball against it, along these lines: @example -$ wget @value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz.sig -$ gpg --verify guix-binary-@value{VERSION}.@var{system}.tar.xz.sig +$ wget @value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig +$ gpg --verify guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig @end example If that command fails because you do not have the required public key, @@ -603,7 +604,7 @@ you may have to run @code{su -} or @code{sudo -i}. As @code{root}, run: @example # cd /tmp # tar --warning=no-timestamp -xf \ - /path/to/guix-binary-@value{VERSION}.@var{system}.tar.xz + /path/to/guix-binary-@value{VERSION}.x86_64-linux.tar.xz # mv var/guix /var/ && mv gnu / @end example @@ -1917,8 +1918,8 @@ about their support in GNU/Linux. An ISO-9660 installation image that can be written to a USB stick or burnt to a DVD can be downloaded from -@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.@var{system}.iso.xz}, -where @var{system} is one of: +@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.xz}, +where you can replace @code{x86_64-linux} with one of: @table @code @item x86_64-linux @@ -1933,8 +1934,8 @@ Make sure to download the associated @file{.sig} file and to verify the authenticity of the image against it, along these lines: @example -$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.@var{system}.iso.xz.sig -$ gpg --verify guix-system-install-@value{VERSION}.@var{system}.iso.xz.sig +$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.xz.sig +$ gpg --verify guix-system-install-@value{VERSION}.x86_64-linux.iso.xz.sig @end example If that command fails because you do not have the required public key, @@ -1965,7 +1966,7 @@ To copy the image to a USB stick, follow these steps: Decompress the image using the @command{xz} command: @example -xz -d guix-system-install-@value{VERSION}.@var{system}.iso.xz +xz -d guix-system-install-@value{VERSION}.x86_64-linux.iso.xz @end example @item @@ -1974,7 +1975,7 @@ its device name. Assuming that the USB stick is known as @file{/dev/sdX}, copy the image with: @example -dd if=guix-system-install-@value{VERSION}.@var{system}.iso of=/dev/sdX +dd if=guix-system-install-@value{VERSION}.x86_64-linux.iso of=/dev/sdX sync @end example @@ -1990,7 +1991,7 @@ To copy the image to a DVD, follow these steps: Decompress the image using the @command{xz} command: @example -xz -d guix-system-install-@value{VERSION}.@var{system}.iso.xz +xz -d guix-system-install-@value{VERSION}.x86_64-linux.iso.xz @end example @item @@ -1999,7 +2000,7 @@ its device name. Assuming that the DVD drive is known as @file{/dev/srX}, copy the image with: @example -growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.@var{system}.iso +growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.x86_64-linux.iso @end example Access to @file{/dev/srX} usually requires root privileges. -- 2.26.2 --MP_/UJ50M5TzkZNZGpWyA00xEhj-- ------------=_1590615004-23049-1--