From unknown Sat Jun 21 03:20:46 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#46803 <46803@debbugs.gnu.org> To: bug#46803 <46803@debbugs.gnu.org> Subject: Status: User manual does not explain Profiles (nor GUIX_PROFILE) Reply-To: bug#46803 <46803@debbugs.gnu.org> Date: Sat, 21 Jun 2025 10:20:46 +0000 retitle 46803 User manual does not explain Profiles (nor GUIX_PROFILE) reassign 46803 guix submitter 46803 Luis Felipe severity 46803 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 16:24:58 2021 Received: (at submit) by debbugs.gnu.org; 26 Feb 2021 21:24:58 +0000 Received: from localhost ([127.0.0.1]:42700 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFkba-0006TA-7j for submit@debbugs.gnu.org; Fri, 26 Feb 2021 16:24:58 -0500 Received: from lists.gnu.org ([209.51.188.17]:56360) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFkbY-0006T3-Ef for submit@debbugs.gnu.org; Fri, 26 Feb 2021 16:24:56 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:35508) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lFkbY-0000Fc-9E for bug-guix@gnu.org; Fri, 26 Feb 2021 16:24:56 -0500 Received: from mail-40140.protonmail.ch ([185.70.40.140]:15192) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lFkbV-0004fW-Du for bug-guix@gnu.org; Fri, 26 Feb 2021 16:24:55 -0500 Date: Fri, 26 Feb 2021 21:24:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1614374690; bh=kfsLSSV6X6r7RFVS5YDNvK8oiE7CEE+pVfu2xTkpsoU=; h=Date:To:From:Reply-To:Subject:From; b=SHPDamE2DARRUTXC3Dl37XZt3+/v/tsFDEyIKVy74KOK/wneD8FKQn+8eKgSRrSJp W/Go8yKK8lz2I7SHBv11a0Ghmf/ZzK/lLLQ7qleblulGXGxM3ZbotUpBkRxx0BDQVw vTDQpkqxANZU37Hd07tAlJQA7NoHgfSryTcmgIEI= To: "bug-guix@gnu.org" From: Luis Felipe Subject: User manual does not explain Profiles (nor GUIX_PROFILE) Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=185.70.40.140; envelope-from=luis.felipe.la@protonmail.com; helo=mail-40140.protonmail.ch X-Spam_score_int: 9 X-Spam_score: 0.9 X-Spam_bar: / X-Spam_report: (0.9 / 5.0 requ) AC_FROM_MANY_DOTS=2.999, BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) 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: , Reply-To: Luis Felipe Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) The Guix reference manual does not seem to explain what profiles are. ## Steps to reproduce Assuming you are browsing the Guix reference manual in Info: 1. Type i (to search for an index topic). 2. Type the word profile and hit Enter. 3. Type , repeatedly to explore all the parts of the manual related to prof= iles. ## Expected result At some point, I get to a section defining what is a profile exactly, a pro= file of what, what can I get from using one or many of them, what is the GU= IX_PROFILE variable, does it accept a single path to a profile or more, and= some use cases and examples. ## Unexpected result I see profiles are mentioned in places where they can be used, but the text= assumes I know what a profile is. Similarly, the GUIX_PROFILE variable doesn't seem to be defined. It seems m= issing from the concept and programming indices. ## Additional information The "Guix Profiles in Practice" recipe in the cookbook defines profiles to = some extent. Maybe some of this information can be used in the manual? --- Luis Felipe L=C3=B3pez Acevedo https://luis-felipe.gitlab.io/ From debbugs-submit-bounces@debbugs.gnu.org Fri Feb 26 18:30:02 2021 Received: (at submit) by debbugs.gnu.org; 26 Feb 2021 23:30:02 +0000 Received: from localhost ([127.0.0.1]:42798 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFmYb-00017D-NO for submit@debbugs.gnu.org; Fri, 26 Feb 2021 18:30:01 -0500 Received: from lists.gnu.org ([209.51.188.17]:37580) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lFmYa-000176-GH for submit@debbugs.gnu.org; Fri, 26 Feb 2021 18:30:00 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:56428) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lFmYa-0005cP-AG for bug-guix@gnu.org; Fri, 26 Feb 2021 18:30:00 -0500 Received: from tobias.gr ([2a02:c205:2020:6054::1]:53758) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lFmYX-0000gW-Km for bug-guix@gnu.org; Fri, 26 Feb 2021 18:29:58 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobias.gr; s=2018; bh=+Wm5Z8pLN7NVHzAK+eQ5xJfpHZc9T/Q2L7GUz7w7EiQ=; h=date:in-reply-to: references:subject:cc:to:from; b=OlZbgDcSI+ihR2QtCNA6mAlc5q5fCvHBXoFiZ we/PrzCOCWMAJLBxUab3nsVfyhuIU7PMDPfYPtcAzBlET308HfKCJNKdAug8xX2mhlGEL3 xEfiu4rjf1yOhVM6HK1JwtWoQECsgEyegX0OcP/8LV9zE5FFN481uiJ1RBlXTGPJAdVdX0 dN03HEPO/NDVjirB/Re7pBZFldVgLf/k/vo5Yfxf82wZZ9Is0MwM8r2hi9PWkEhgSFIych TXiONJ8kWGAr8pElOwAa6vpk4g8+gvM5mPrA/8w3ClGTHEZENyZO4P4jBtcnp0YIdMNpMp o4jivnYVj59VoJ/moZpYBW3Yg== Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 3cd6e7d3 (TLSv1.2:ECDHE-ECDSA-AES256-GCM-SHA384:256:NO); Fri, 26 Feb 2021 23:30:47 +0000 (UTC) BIMI-Selector: v=BIMI1; s=default; From: Tobias Geerinckx-Rice To: Luis Felipe Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) References: In-reply-to: Date: Sat, 27 Feb 2021 00:30:18 +0100 Message-ID: <877dmube5x.fsf@nckx> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Received-SPF: pass client-ip=2a02:c205:2020:6054::1; envelope-from=me@tobias.gr; helo=tobias.gr 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit Cc: 46803@debbugs.gnu.org, bug-guix@gnu.org 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: -2.4 (--) --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Luis Felipe, I think that would be very helpful. I'm trying to think of a=20 concise, correct, but actually useful definition of profiles for=20 someone not already familiar with them or Guix. Out of curiosity: how do you intuitively understand profiles, as=20 someone who's used Guix for a while? Luis Felipe via Bug reports for GNU Guix =E5=86=99=E9=81=93=EF=BC=9A > [...] what is the GUIX_PROFILE variable, does it accept a single > path to a profile or more, and some use cases and=20 > examples. [...] I don't think we should document GUIX_PROFILE. It's not part of=20 the definition of Guix profiles. It should not matter to users=20 nor should they rely on previously observed behaviour. AIUI there=20 are no supported =E2=80=98use cases=E2=80=99, beyond copy-pasting Guix erro= r=20 messages... > Similarly, the GUIX_PROFILE variable doesn't seem to be=20 > defined. It seems missing from the concept and programming=20 > indices. ...so this part isn't unexpected. Kind regards, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iIMEARYKACsWIQT12iAyS4c9C3o4dnINsP+IT1VteQUCYDmEig0cbWVAdG9iaWFz LmdyAAoJEA2w/4hPVW15qzUA/0tMZwKrOunVVfnlFjz68X2WWFTz7kcoicAoRFQU sgWXAQDC/QEVyNJqDmmu2QPWWKS52pQP8LWT1tsDXmN0+2HrCg== =Inu9 -----END PGP SIGNATURE----- --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Sat Feb 27 13:12:02 2021 Received: (at submit) by debbugs.gnu.org; 27 Feb 2021 18:12:02 +0000 Received: from localhost ([127.0.0.1]:45340 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lG44P-0003GR-MJ for submit@debbugs.gnu.org; Sat, 27 Feb 2021 13:12:01 -0500 Received: from lists.gnu.org ([209.51.188.17]:37118) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lG44N-0003GE-6O for submit@debbugs.gnu.org; Sat, 27 Feb 2021 13:11:59 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:37698) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lG44M-0001Ah-Vb for bug-guix@gnu.org; Sat, 27 Feb 2021 13:11:59 -0500 Received: from mail-40137.protonmail.ch ([185.70.40.137]:31234) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lG44K-0006jP-Ae for bug-guix@gnu.org; Sat, 27 Feb 2021 13:11:58 -0500 Date: Sat, 27 Feb 2021 18:11:47 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1614449512; bh=RM1Hpd0rbCNRwWLQP0LVjS7H7G2B0RFWiW6SKEllCAs=; h=Date:To:From:Cc:Reply-To:Subject:In-Reply-To:References:From; b=agQbqOyrBqCQj9/HGY3d6s11BIjcVHEdt3+EvZmxdpwq45ddbKvc0nbOUYRyEyUQe M8AwMsmSnAVr3K9j6I2RriPkuKkbjEfNUz+csLdHbkDp8/ZAO8NSOrSyIREw04Wmpw wytwByMvmSmi8FsuyHrX3AXnAY1NVy6eWFiHdXVM= To: Tobias Geerinckx-Rice From: Luis Felipe Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) Message-ID: In-Reply-To: <877dmube5x.fsf@nckx> References: <877dmube5x.fsf@nckx> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch Received-SPF: pass client-ip=185.70.40.137; envelope-from=luis.felipe.la@protonmail.com; helo=mail-40137.protonmail.ch 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit Cc: "46803@debbugs.gnu.org" <46803@debbugs.gnu.org>, "bug-guix@gnu.org" 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: , Reply-To: Luis Felipe Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) On Friday, February 26, 2021 11:30 PM, Tobias Geerinckx-Rice = wrote: > Luis Felipe, > > I think that would be very helpful. I'm trying to think of a concise, cor= rect, but actually useful definition of profiles for someone not already fa= miliar with them or Guix. > > Out of curiosity: how do you intuitively understand profiles, as someone = who's used Guix for a while? I think I didn't intuitively understand profiles. I think I actually starte= d using them last year (apart from the user profile) after reading the Guix= Profiles in Practice recipe, which made things clearer to me (but I don't = think I grok the concept). So, right now, I see a profile like a collection of packages that you can a= ctivate/deactivate in your environment by setting the GUIX_PROFILE environm= ent variable and sourcing its profile file. > Luis Felipe via Bug reports for GNU Guix =E5=86=99=E9=81=93=EF=BC=9A > > > [...] what is the GUIX_PROFILE variable, does it accept a single > > path to a profile or more, and some use cases and > examples. [...] > > I don't think we should document GUIX_PROFILE. It's not part of the defin= ition of Guix profiles. It should not matter to users nor should they rely = on previously observed behaviour. AIUI there are no supported =E2=80=98use = cases=E2=80=99, beyond copy-pasting Guix error messages... In the Guix Profiles in Practice recipe, for example, you are instructed to= set GUIX_PROFILE and then use it when sourcing the profile. So I thought i= t deserved an entry in the index, since it is mentioned so often when worki= ng with profiles. I think I was expecting something like: GUIX_PROFILE This is an environment variable that you can set to [...]. Its value is an absolute path to a Guix profile. See Profiles for more information. Now I'm confused.. :) From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 01 04:59:42 2021 Received: (at submit) by debbugs.gnu.org; 1 Mar 2021 09:59:42 +0000 Received: from localhost ([127.0.0.1]:48161 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGfL3-0004YT-UQ for submit@debbugs.gnu.org; Mon, 01 Mar 2021 04:59:42 -0500 Received: from lists.gnu.org ([209.51.188.17]:39596) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGfL3-0004YM-4w for submit@debbugs.gnu.org; Mon, 01 Mar 2021 04:59:41 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:36580) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lGfL2-0005UH-S9 for bug-guix@gnu.org; Mon, 01 Mar 2021 04:59:40 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:41978) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lGfL2-0005al-0g; Mon, 01 Mar 2021 04:59:40 -0500 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=50320 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lGfKz-00072O-C6; Mon, 01 Mar 2021 04:59:38 -0500 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Tobias Geerinckx-Rice via Bug reports for GNU Guix Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) References: <877dmube5x.fsf@nckx> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 11 =?utf-8?Q?Vent=C3=B4se?= an 229 de la =?utf-8?Q?R?= =?utf-8?Q?=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Mon, 01 Mar 2021 10:59:35 +0100 In-Reply-To: <877dmube5x.fsf@nckx> (Tobias Geerinckx-Rice via Bug reports for's message of "Sat, 27 Feb 2021 00:30:18 +0100") Message-ID: <87tupvtcs8.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit Cc: Luis Felipe , Tobias Geerinckx-Rice , 46803@debbugs.gnu.org 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 (---) Hi, Tobias Geerinckx-Rice via Bug reports for GNU Guix skribis: > I think that would be very helpful. I'm trying to think of a concise, > correct, but actually useful definition of profiles for someone not > already familiar with them or Guix. > > Out of curiosity: how do you intuitively understand profiles, as > someone who's used Guix for a while? I=E2=80=99m not Luis but I usually say that a profile is the location of a = set of installed packages. > Luis Felipe via Bug reports for GNU Guix =E5=86=99=E9=81=93=EF=BC=9A >> [...] what is the GUIX_PROFILE variable, does it accept a single >> path to a profile or more, and some use cases and examples. [...] > > I don't think we should document GUIX_PROFILE. It's not part of the > definition of Guix profiles. It should not matter to users nor should > they rely on previously observed behaviour. AIUI there are no > supported =E2=80=98use cases=E2=80=99, beyond copy-pasting Guix error mes= sages... Agreed. =E2=80=98GUIX_PROFILE=E2=80=99 has no significance as an environme= nt variable; it=E2=80=99s referred to by the generated =E2=80=98etc/profile=E2=80=99, bu= t it=E2=80=99s usually a shell variable, not an environment variable. Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 01 05:34:19 2021 Received: (at 46803) by debbugs.gnu.org; 1 Mar 2021 10:34:19 +0000 Received: from localhost ([127.0.0.1]:48228 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGfsY-0007XN-QV for submit@debbugs.gnu.org; Mon, 01 Mar 2021 05:34:19 -0500 Received: from mail-wr1-f49.google.com ([209.85.221.49]:37507) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lGfsX-0007X9-5n for 46803@debbugs.gnu.org; Mon, 01 Mar 2021 05:34:17 -0500 Received: by mail-wr1-f49.google.com with SMTP id v15so15562007wrx.4 for <46803@debbugs.gnu.org>; Mon, 01 Mar 2021 02:34:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=AUwEoV8EjSV7LnZf7M9cHt8mVComImhcvN6rmP8hYDc=; b=kFebj5E/XUofeSI79OyQScmlLNdjhdzEgk7JNGwhF/MC2gxWwjog9qsPI8BeeruqlB UpylZweW1UhT+LR/XiiL7II5Pto+VYVLIwWN77c0UflyMdPU4npoXU0CuZ7Mfb87a4/s h28QzDw0cGQIsVDnQy5SdlM0SOuEqGir732awRh9bEU1mEIo3I2GJLG7B+kDSnMex1Yh 1rpkb83yYY5MaFJwrbDzhXYx4pk9XLTBeg9GxXMfwuEUGnZptCI7pKssSN5CIhZImoE8 PcuU2w9NqQKAJTMzMVvYHsx/J0012s6H9cYJTVWOuw4JGq0PPw8z80Ts57beLvNc4ZPy S+mA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=AUwEoV8EjSV7LnZf7M9cHt8mVComImhcvN6rmP8hYDc=; b=pbxLZdPXN5NZ2Ah1t/97VivD612R7tJXzNXh86PzfO/no9qUJmUnmQsgYnEwPsVscD NJ1IB+CNsF4HUd0mTcsvY0Bw4SJ0Olcu9VIKyihDD+LljmioDbG3or36sjU4HCniICIR 9l/eMSy42R5YkueAnbVoL7Mwcp868xWb1GmDa95TBbHJv5uWRqxLgXscW8EdWGJTBhwO A4RFefpWEZZOFTwggBwGwtmrpgIjHSPh8JqU05pv2j9pvQQzPAjVz6LlNPKfc6GiC4/r t2FbEVFB6V+eSOVD/2FvOap6ZMa2TX/xpShc3fYtmUtG86eNvWDlBUKxhremaHUNrwvM vklA== X-Gm-Message-State: AOAM531MydIplY8cLe/FqClrb7XzxTmgqSwYP1DNWketYHWqlrDYI4WT lyX6F6xMIWA3MnBCMrTl8rHhF3x9bRE= X-Google-Smtp-Source: ABdhPJw8ugKQzat85K4WIaRfg53wW+1gZKOSufGvOXp01+LWZehpXZrmdwdXVmb2mnoUClp4qQDnMw== X-Received: by 2002:adf:9b82:: with SMTP id d2mr16193061wrc.193.1614594851221; Mon, 01 Mar 2021 02:34:11 -0800 (PST) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id b17sm2074023wrt.17.2021.03.01.02.34.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 01 Mar 2021 02:34:10 -0800 (PST) From: zimoun To: Tobias Geerinckx-Rice , Luis Felipe Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) In-Reply-To: <877dmube5x.fsf@nckx> References: <877dmube5x.fsf@nckx> Date: Mon, 01 Mar 2021 11:28:23 +0100 Message-ID: <86mtvn9ni0.fsf@gmail.com> 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: 46803 Cc: 46803@debbugs.gnu.org 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 (-) Hi Tobias, On Sat, 27 Feb 2021 at 00:30, Tobias Geerinckx-Rice via Bug reports for GNU= Guix wrote: > Out of curiosity: how do you intuitively understand profiles, as=20 > someone who's used Guix for a while? Effectively, profiles is not explicitly defined but implicitly, for instance: Otherwise, the most explicit definition is in the Cookbook: Guix provides a very useful feature that may be quite foreign to newcomers: profiles. They are a way to group package installations together and all users on the same system are free to use as many profiles as they want. BTW, I remember that coming from Conda (and Python), I was confused by what was Profile and Environment in Guix, since =E2=80=99environment=E2=80= =99 (in Conda) corresponds to Profile (in Guix). Anyway, for words inspiration, Conda=E2=80=99s doc: A conda environment is a directory that contains a specific collect= ion of conda packages that you have installed. For example, you may hav= e one environment with NumPy 1.7 and its dependencies, and another enviro= nment with NumPy 1.6 for legacy testing. If you change one environment, y= our other environments are not affected. You can easily activate or deactivate environments, which is how you switch between them. You = can also share your environment with someone by giving them a copy of y= our environment.yaml file. For more information, see Managing environme= nts. And from this old time, I remember that examples really helps, for instance. . Therefore, the section =C2=ABGetting Started=C2=BB could be a bit extended = with a paragraph about Profiles and one or two examples. WDYT? Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Sun Mar 14 06:56:59 2021 Received: (at 46803) by debbugs.gnu.org; 14 Mar 2021 10:56:59 +0000 Received: from localhost ([127.0.0.1]:33002 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lLOQc-0007Pg-Og for submit@debbugs.gnu.org; Sun, 14 Mar 2021 06:56:59 -0400 Received: from eggs.gnu.org ([209.51.188.92]:55382) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lLOQb-0007PT-Me for 46803@debbugs.gnu.org; Sun, 14 Mar 2021 06:56:57 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:50495) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lLOQV-0007sW-5d; Sun, 14 Mar 2021 06:56:51 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=39670 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lLOQT-0005AI-KY; Sun, 14 Mar 2021 06:56:50 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: zimoun Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) References: <877dmube5x.fsf@nckx> <86mtvn9ni0.fsf@gmail.com> Date: Sun, 14 Mar 2021 11:56:47 +0100 In-Reply-To: <86mtvn9ni0.fsf@gmail.com> (zimoun's message of "Mon, 01 Mar 2021 11:28:23 +0100") Message-ID: <87h7lem2a8.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 46803 Cc: Luis Felipe , Tobias Geerinckx-Rice , 46803@debbugs.gnu.org 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 (-) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hello, zimoun skribis: > Effectively, profiles is not explicitly defined but implicitly, for > instance: > > > > Otherwise, the most explicit definition is in the Cookbook: > > Guix provides a very useful feature that may be quite foreign to > newcomers: profiles. They are a way to group package > installations together and all users on the same system are free > to use as many profiles as they want. > > [...] > > > And from this old time, I remember that examples really helps, for > instance. > > . > > Therefore, the section =C2=ABGetting Started=C2=BB could be a bit extende= d with a > paragraph about Profiles and one or two examples. WDYT? > > Thanks for the pointers! How about these changes to =E2=80=9CGetting Start= ed=E2=80=9D and =E2=80=9CInvoking guix package=E2=80=9D? Ludo=E2=80=99. --=-=-= Content-Type: text/x-patch Content-Disposition: inline diff --git a/doc/guix.texi b/doc/guix.texi index 4cf241c56a..00bd087628 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -2751,7 +2751,10 @@ you can go ahead and install it (run this command as a regular user, guix install emacs @end example -You've installed your first package, congrats! In the process, you've +You've installed your first package, congrats! The package is now +visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a +profile is a directory containing installed packages. +In the process, you've probably noticed that Guix downloaded pre-built binaries; or, if you explicitly chose to @emph{not} use pre-built binaries, then probably Guix is still building software (@pxref{Substitutes}, for more info). @@ -3061,7 +3064,10 @@ retaining precise @dfn{provenance tracking} of the software. @cindex package removal The @command{guix package} command is the tool that allows users to install, upgrade, and remove packages, as well as rolling back to -previous configurations. It operates only on the user's own profile, +previous configurations. These operations work on a user +@dfn{profile}---a directory of installed packages. Each user has a +default profile in @file{$HOME/.guix-profile}. +The command operates only on the user's own profile, and works with normal user privileges (@pxref{Features}). Its syntax is: --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 15 05:43:44 2021 Received: (at 46803) by debbugs.gnu.org; 15 Mar 2021 09:43:44 +0000 Received: from localhost ([127.0.0.1]:34894 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lLjlI-0007HV-8r for submit@debbugs.gnu.org; Mon, 15 Mar 2021 05:43:44 -0400 Received: from mail-wm1-f52.google.com ([209.85.128.52]:34417) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lLjlG-0007HG-56 for 46803@debbugs.gnu.org; Mon, 15 Mar 2021 05:43:42 -0400 Received: by mail-wm1-f52.google.com with SMTP id n11-20020a05600c4f8bb029010e5cf86347so1967854wmq.1 for <46803@debbugs.gnu.org>; Mon, 15 Mar 2021 02:43:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version:content-transfer-encoding; bh=KYCwpKTw2b2Y5nGRpSIKBBc3w462AUVQzHmFqoYkJhM=; b=CBJAoR4CqM9NWlNg5XoCeeMm+fggmX3fRD4zE6CO5c5RhWhxtOikFIDeWEVV27tU0m 6KizjRDjD6Z9L1CzUCIh0GvaV5cpSFXXjEUJkcDXyLFjAJMx7p7yi5Toq6GFiJdbxiIG 0bPzY21JCZj66/xad0ALNWp6eGey8FTWV5rBfqflouhiQHtGC1gXxIDFOZDDl85FB4c5 CBOsb2qSl03t2K8qWpaQ6Z4EITBI2v0dqhJlEvqARZfcmY6tevxjhU623O0XTQGlUlcS QwobDwuwsk6tFVPy+gQFQBctm7R070+5I0KKYYCk6DJDN7fgHJUk0zhXWhVCKpRc/nEQ n4Rw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=KYCwpKTw2b2Y5nGRpSIKBBc3w462AUVQzHmFqoYkJhM=; b=RzqjPeUjGe/lyeuNg4Cz8lViWYC2aZwavvFyfEorNfHuWl/3+Jm8dsxbuFOAiVgxlE HyDolM+g8X0569JwhsAGzGfhne6ud/TWkZCGEMWeHp+HBo9+mP4DxyQUwqYUhBiEqpRS 3J81cNgt8J/b5/NHVCzJHcaIgzcVFM/DyN2fWttDwtW4Mt6yb4Vm4Ithq+t3MY752lxP XEGpuCDo3YCGrqiwrbPIyG02KjZN397o/O2AUxm4rUJ5SQ3tIvZ2Wctu+Gy4MNSo/+9C MNeSfsrciScF4X8zMpmbJSiuY9bEWkyYMzR/2SaR7vJ4pQlsdXYtBMyJqGEBi8jzkgj3 Sr/A== X-Gm-Message-State: AOAM532BQ26VCAwH8hIUAC7b3r2504OJA95MUKWcvR3UllzUXUefFqft r695EYcshYwESPYQF46/syyPLer6mvg= X-Google-Smtp-Source: ABdhPJwCE+7U6nS3/g4hI1KlLKxUGrmvdHjfvkm2dquTv8fDg+RXMyrxyNiGGP5M3zRHBtnmlkJ6cg== X-Received: by 2002:a05:600c:3541:: with SMTP id i1mr10161168wmq.97.1615801416121; Mon, 15 Mar 2021 02:43:36 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id s23sm11362420wmc.35.2021.03.15.02.43.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Mar 2021 02:43:35 -0700 (PDT) From: zimoun To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) In-Reply-To: <87h7lem2a8.fsf@gnu.org> References: <877dmube5x.fsf@nckx> <86mtvn9ni0.fsf@gmail.com> <87h7lem2a8.fsf@gnu.org> Date: Mon, 15 Mar 2021 10:43:04 +0100 Message-ID: <86h7lcda6v.fsf@gmail.com> 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: 46803 Cc: Luis Felipe , Tobias Geerinckx-Rice , 46803@debbugs.gnu.org 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 (-) Hi Ludo, On Sun, 14 Mar 2021 at 11:56, Ludovic Court=C3=A8s wrote: > diff --git a/doc/guix.texi b/doc/guix.texi > index 4cf241c56a..00bd087628 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -2751,7 +2751,10 @@ you can go ahead and install it (run this command = as a regular user, > guix install emacs > @end example >=20=20 > -You've installed your first package, congrats! In the process, you've > +You've installed your first package, congrats! The package is now > +visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a > +profile is a directory containing installed packages. > +In the process, you've I would add a link to the index term =E2=80=99profile=E2=80=99 in =E2=80=9C= Invoking guix package=E2=80=9D: --8<---------------cut here---------------start------------->8--- @cindex profile For each user, a symlink to the user's default profile is automatically created in @file{$HOME/.guix-profile}. This symlink always points to the =E2=80=A6 --8<---------------cut here---------------end--------------->8--- > probably noticed that Guix downloaded pre-built binaries; or, if you > explicitly chose to @emph{not} use pre-built binaries, then probably > Guix is still building software (@pxref{Substitutes}, for more info). > @@ -3061,7 +3064,10 @@ retaining precise @dfn{provenance tracking} of the= software. > @cindex package removal > The @command{guix package} command is the tool that allows users to > install, upgrade, and remove packages, as well as rolling back to > -previous configurations. It operates only on the user's own profile, > +previous configurations. These operations work on a user > +@dfn{profile}---a directory of installed packages. Each user has a > +default profile in @file{$HOME/.guix-profile}. > +The command operates only on the user's own profile, > and works with normal user privileges (@pxref{Features}). Its syntax > is: I would add an index term and/or anchor and points to the option: --8<---------------cut here---------------start------------->8--- @item --profile=3D@var{profile} @itemx -p @var{profile} Use @var{profile} instead of the user's default profile. @var{profile} must be the name of a file that will be created upon completion. Concretely, @var{profile} will be a mere symbolic link (``symlink'') pointing to the actual profile where packages are installed: =E2=80=A6 --8<---------------cut here---------------end--------------->8--- Well, LGTM. :-) Cheers, simon From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 17 09:55:00 2021 Received: (at 46803-done) by debbugs.gnu.org; 17 Mar 2021 13:55:00 +0000 Received: from localhost ([127.0.0.1]:42403 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lMWdY-0005YS-Dr for submit@debbugs.gnu.org; Wed, 17 Mar 2021 09:55:00 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57162) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lMWdW-0005YE-EM for 46803-done@debbugs.gnu.org; Wed, 17 Mar 2021 09:54:58 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36369) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lMWdQ-0006sF-Rq; Wed, 17 Mar 2021 09:54:52 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=47204 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lMWdM-0006f4-AJ; Wed, 17 Mar 2021 09:54:52 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: zimoun Subject: Re: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) References: <877dmube5x.fsf@nckx> <86mtvn9ni0.fsf@gmail.com> <87h7lem2a8.fsf@gnu.org> <86h7lcda6v.fsf@gmail.com> Date: Wed, 17 Mar 2021 14:54:46 +0100 In-Reply-To: <86h7lcda6v.fsf@gmail.com> (zimoun's message of "Mon, 15 Mar 2021 10:43:04 +0100") Message-ID: <87eegd51i1.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 46803-done Cc: Luis Felipe , Tobias Geerinckx-Rice , 46803-done@debbugs.gnu.org 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 (-) Hi zimoun, Pushed something like the initial patch + index entries as 0571aa7abf262f617add727ac03e3bf63d41ae6d. Thank you! Ludo=E2=80=99. From unknown Sat Jun 21 03:20:46 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 15 Apr 2021 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator