From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:c151::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id yItMHgfsTWBLaQAA0tVLHw (envelope-from ) for ; Sun, 14 Mar 2021 10:57:11 +0000 Received: from aspmx2.migadu.com ([2001:41d0:2:c151::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id gH4AGgfsTWDgTQAAbx9fmQ (envelope-from ) for ; Sun, 14 Mar 2021 10:57:11 +0000 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 aspmx2.migadu.com (Postfix) with ESMTPS id C48D2F25B for ; Sun, 14 Mar 2021 11:57:10 +0100 (CET) Received: from localhost ([::1]:34964 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lLOQn-0006t2-Oz for larch@yhetil.org; Sun, 14 Mar 2021 06:57:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:45036) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lLOQf-0006si-U8 for bug-guix@gnu.org; Sun, 14 Mar 2021 06:57:01 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:49689) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lLOQf-0007z1-Mh for bug-guix@gnu.org; Sun, 14 Mar 2021 06:57:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lLOQf-0007Py-Lv for bug-guix@gnu.org; Sun, 14 Mar 2021 06:57:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Sun, 14 Mar 2021 10:57:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 46803 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: zimoun Received: via spool by 46803-submit@debbugs.gnu.org id=B46803.161571941928504 (code B ref 46803); Sun, 14 Mar 2021 10:57:01 +0000 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: Ludovic =?UTF-8?Q?Court=C3=A8s?= 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Luis Felipe , 46803@debbugs.gnu.org Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1615719431; 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:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post; bh=tkyi2wFaZlumqL5P6mErkGdfw0kiKU5MSYNk0/TSjlQ=; b=FPKp4omYFZCY0YBN7wkib89JA6UKKGl0b3QjKN1Q0mrUaN80eFUOdCf9VUp60fkEQIlX4k 7UbZPm2GdiH1Gg+2fdWjsw2PhdZOqG5hZNHIgu4EYirexFDwuLnwpyjXi1GlAR+/jKr8Ml HVH/SNkYTUXq2vYSrUSUfzlCc3gReU6VBK0xD7ji7J0yohOiGLC2fA6u9UJawQpgTSp1uk dKdR/RUntZNnS1S16Rkld0n1amp5DmJ/QJ5F8oftjCDN5RxKgNWaP+uQJV6yoSNLQGCwgK u9tDrpgOVW4FV4yq0o6vEc8QzE1+kHRi0d3lDG35RRaIOd1HCz67rYy7YHzUlg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1615719431; a=rsa-sha256; cv=none; b=O/fXXH/CbeW4WEgNO7kjO4y+imWrQEru6lynL29VYFP2nLDScEEtkJ86M9o9yN4oQV4mhL fJjceNLPYjtpH1HWhAscTwfge7c0I+UEVEsop/EOcaMIlldaQGw0ikca8XVBIp7rJf6LF5 xAGNRqRjneilhCl1T3H1LR8dv2KvWiT4dGGA1gQlaeBxbfI2qw1ZjbNN67GHanjOHaXs+H sUKUjY9+BJTEMUK073fdkpKjk9FaWs08T5cGJ8AlOVlu2alQvgZk5iCZhOnlU3Ak7l5T3B lLcYrVnPwIbzC7mW1or1KxJgsnQ5o8EuRcKpuzqGkmadEjl0OwEKccpTQgW6fA== ARC-Authentication-Results: i=1; aspmx2.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx2.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Spam-Score: -2.90 Authentication-Results: aspmx2.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx2.migadu.com: domain of bug-guix-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=bug-guix-bounces@gnu.org X-Migadu-Queue-Id: C48D2F25B X-Spam-Score: -2.90 X-Migadu-Scanner: scn0.migadu.com X-TUID: L9SrIjfbr0gl --=-=-= 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: --=-=-=--