From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms1.migadu.com with LMTPS id uFwYGSSEOmZ6AAEAe85BDQ:P1 (envelope-from ) for ; Tue, 07 May 2024 21:42:28 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id uFwYGSSEOmZ6AAEAe85BDQ (envelope-from ) for ; Tue, 07 May 2024 21:42:28 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=LheUJwDF; 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=1715110948; 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=i7yvfbp4IVgW3km3DV1zF30IIFdbPzj4xC8mMagxNB8=; b=YjxQtWz5fW77m/sb67mQu50RZzRsdYs+sCGv7GsUEuYh9WPIVrq6LmdduYzjaHH1qhqrPl gaShhn4IIoDUM1hvrCP0rh/WpJpvQYSeCrSouUVGu2vPOXHaOdM54iPObm8SJ0xSTlAu/K vzpbIeaDp2/1cshTPyn4pqHTk/0IXY3mGnrSpW1rRa+z5rPtMSGpVAR7F6Q0kOlqnOExQx HvA3IvS4hT2rL8LON80gV6H7Vcs6CgwayP3pt/QDyhR3HBbAkvkxyLw8n0rMmzIPPk3bpG 2eS5sUDcb89Lq+4uC2Qlh5F9chys6NXZ0b9qeGwV252+dFpWzuNunzcYKzJmeA== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1715110948; a=rsa-sha256; cv=pass; b=WM2a2bmC38BXrY+DvA42f2kMZ7Dm++M5yqWNi8SF8YR1DvQfx+f5TwGNOf7QaV8ReP0sHJ PmueYGtC+5KFjBAo3+JwrGHbgEwGQOKzt7f2fTpUQZWKQ/rQNYks5z2q/LAylKcSs45D9h qcYXnJEgf6wiUYu7qe/sDZFD6lUmOakl9BICiJByENfPQ2TNEiU2MQg3+B8SAHL6hnlL0A 4PW+sV1yV+Fty+QQDB002WGMHxOO8lqc2gphPmVVB8yjJS7j1jPMucbTMXJmt1LsQ8U1of UJw1arI7RzGMsZjQR0vU8PIwFGP9mpJjHSovJ1UWDUjJ33adJwtyM+2mD7Qksw== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=excalamus.com header.s=zmail header.b=LheUJwDF; 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 3E36B743E7 for ; Tue, 07 May 2024 21:42:28 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1s4QhH-0008Fu-8t; Tue, 07 May 2024 15:41:55 -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 1s4QhF-0008EB-RR for guix-devel@gnu.org; Tue, 07 May 2024 15:41:53 -0400 Received: from sender4-pp-f112.zoho.com ([136.143.188.112]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1s4QhD-0007KI-Ny for guix-devel@gnu.org; Tue, 07 May 2024 15:41:53 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1715110907; cv=none; d=zohomail.com; s=zohoarc; b=EuuljWFPNa8LpcplOv6LMZtyiid3jVa/fRhrWtoMLyeILOK2HfaErTrHjVOT1sgcNNEHxZb5/oR7i2vdQAuPodEHHof5RmwuiWNM2WtCUgubkcmCnxeDkUrms+l5Zmw/Hssgz/s08zPOW8UrlUWsz6jZB9Fzbr9pxuLD+eBsTaM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1715110907; 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=i7yvfbp4IVgW3km3DV1zF30IIFdbPzj4xC8mMagxNB8=; b=dV8r/TWN5sdeFEKwQ8dvusDr8+jfFe67a2BwgBZj20hv+isJUyC/OftE1vvcbXM1nNva1C6I4NZ26eZkNioZaj0la0z2SxwRqbl5IwAkhJez1lhHHbYUQ4PmkWqcRxQtMfnZ9YkUZX16LhKG717AksJqQ7Azygk5ZhlZSy6rknw= 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=1715110907; 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=i7yvfbp4IVgW3km3DV1zF30IIFdbPzj4xC8mMagxNB8=; b=LheUJwDF432QnGS2tv47kwpQIYunsXowAYrWSgKSa+Nlelpkch6q7Kh1jdm/u0aw DEljy0a1c9SYPrDyo8JRfNHeuLA1VLyRs1KF/WSiiaVWYGqoyu75RlqItuwZPCGVuwf zH5or+ot+EDXGUOCWzaA+u9xZiBOf5x5E5ZkgZr0= Received: from mail.zoho.com by mx.zohomail.com with SMTP id 1715110903216415.1185721350349; Tue, 7 May 2024 12:41:43 -0700 (PDT) Date: Tue, 07 May 2024 21:41:42 +0200 From: Matt To: "guix-devel" Cc: "pelzflorian" , "dev" , "maximcournoyer" Message-Id: <18f54937bf9.bbb95b97196253.976385347649899026@excalamus.com> In-Reply-To: <87a5p8yn4p.fsf@dadoes.de> References: <87a5p8yn4p.fsf@dadoes.de> Subject: [PATCH] doc: Clarify need to update search paths on foreign distro (was Re: Feedback of the GNU Guix manual) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_640197_1087855859.1715110902777" Importance: Medium User-Agent: Zoho Mail X-Mailer: Zoho Mail X-Zoho-Virus-Status: 1 X-Zoho-AV-Stamp: zmail-av-1.1.0/215.87.9 Received-SPF: pass client-ip=136.143.188.112; envelope-from=matt@excalamus.com; helo=sender4-pp-f112.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_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=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: -5.85 X-Spam-Score: -5.85 X-Migadu-Queue-Id: 3E36B743E7 X-Migadu-Scanner: mx11.migadu.com X-TUID: HruU71V6D1Hl ------=_Part_640197_1087855859.1715110902777 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable 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 five items. The sixth item was fixed already i= n https://git.savannah.gnu.org/cgit/guix.git/commit/?id=3Dcb3f833aaa5326e653b= 128bfd7b13d553f7c2a47 The next item reported is: #+begin_quote 6.7 L37 true for Guix System as well? The result of running =E2=80=98guix pull=E2=80=99 is a =E2=80=9Cprofile=E2= =80=9D available under =E2=80=98~/.config/guix/current=E2=80=99 containing the latest Guix. Thus, = make sure to add it to the beginning of your search path so that you use the latest version, and similarly for the Info manual (*note Documentation::): export PATH=3D"$HOME/.config/guix/current/bin:$PATH" export INFOPATH=3D"$HOME/.config/guix/current/share/info:$INFOPATH" #+end_quote As far as I know, exporting like this is only necessary on foreign distros. The attached patch makes this explicit. It also provides information for p= eople unfamiliar with the concept of a "search path" or how shells work by = suggesting the exports be added to .bashrc and tries to clarify the consequ= ences of not doing this. Unnecessary words were struck to reduce the overall word count. According = to M-x count-words-region, the patch adds only 6 words (which is less than = the 7 needed for "users of Guix on a foreign distro", itself hard to reduce= ). ------=_Part_640197_1087855859.1715110902777 Content-Type: application/octet-stream; name=0001-doc-Clarify-need-to-update-search-paths-on-foreign-d.patch Content-Transfer-Encoding: 7bit X-ZM_AttachId: 139344037027770170 Content-Disposition: attachment; filename=0001-doc-Clarify-need-to-update-search-paths-on-foreign-d.patch >From 61d7fd377f428bf228e77f9e64b9e55e903a63f3 Mon Sep 17 00:00:00 2001 From: Matthew Trzcinski Date: Tue, 7 May 2024 21:30:28 +0200 Subject: [PATCH] doc: Clarify need to update search paths on foreign distro. * doc/guix.texi (Invoking guix pull): Make explicit the need to update PATH and INFOPATH on foreign distros after running 'guix pull'. Give example of where users may make the updates, as well as clearify the explanation why. --- doc/guix.texi | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 1c1e0164e7..af08dd4046 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -4403,11 +4403,12 @@ instance, when user @code{root} runs @command{guix pull}, this has no effect on the version of Guix that user @code{alice} sees, and vice versa. -The result of running @command{guix pull} is a @dfn{profile} available -under @file{~/.config/guix/current} containing the latest Guix. Thus, -make sure to add it to the beginning of your search path so that you use -the latest version, and similarly for the Info manual -(@pxref{Documentation}): +@command{guix pull} creates a new @dfn{profile} in +@file{~/.config/guix/current} containing the latest Guix. Users of Guix +on a foreign distro should add this profile to the beginning of their +search path (for example in @file{.bashrc}) to ensure that +@command{guix} and @command{info guix} (@pxref{Documentation}) reference +the latest versions: @example export PATH="$HOME/.config/guix/current/bin:$PATH" -- 2.41.0 ------=_Part_640197_1087855859.1715110902777--