From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id GK2cKoosT2APWwAA0tVLHw (envelope-from ) for ; Mon, 15 Mar 2021 09:44:42 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id GDN1JoosT2BDCAAAB5/wlQ (envelope-from ) for ; Mon, 15 Mar 2021 09:44:42 +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 aspmx1.migadu.com (Postfix) with ESMTPS id 0266B203D7 for ; Mon, 15 Mar 2021 10:44:42 +0100 (CET) Received: from localhost ([::1]:36290 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lLjmC-00032x-EW for larch@yhetil.org; Mon, 15 Mar 2021 05:44:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41802) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lLjla-000320-Vd for bug-guix@gnu.org; Mon, 15 Mar 2021 05:44:06 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:51581) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lLjlZ-00080u-TG for bug-guix@gnu.org; Mon, 15 Mar 2021 05:44:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lLjlZ-0007IB-Ne for bug-guix@gnu.org; Mon, 15 Mar 2021 05:44:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#46803: User manual does not explain Profiles (nor GUIX_PROFILE) Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Mon, 15 Mar 2021 09:44: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: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 46803-submit@debbugs.gnu.org id=B46803.161580142427997 (code B ref 46803); Mon, 15 Mar 2021 09:44:01 +0000 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 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-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=1615801482; 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: content-transfer-encoding:content-transfer-encoding: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:dkim-signature; bh=KYCwpKTw2b2Y5nGRpSIKBBc3w462AUVQzHmFqoYkJhM=; b=u7g22vyKijzepTKGEUvxQ3uBSE5L4ZAKzFE4MutDPSRCt/HZULHkdXtovTbpxoURT34ZFN 5TNPvR0ZlQm7eDWbrL0tz+GtSHjkMKrdrINzqBQmXaeNZ6D4dNJXLOKdK9DFF46L4NdrN5 1TijC6qUmlH9tqOY5GBlQErCBJUkYrJ2dAElajz6pYfpShZv1HZkuu1MJg7SAA3pEJEorX 7Dx6OYVQeeW+dE/sFrH5n5u1GF/l8B2HaDIwQ91Z2z1z2K+z+vhcKKyW0f+kfUo18wWgWy ma9tSaR0AtPMcs5dYMv3X7FSUBPOHrSmhDtXHu+q41rDHE1hbFgHmaqp6VcXIw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1615801482; a=rsa-sha256; cv=none; b=k46dEgI4ZUo1wvdE3F9mtxZc6GQd3cdZWzWNVb17gfjgdcMQfdINI8HMrQTTW105NwFzIN rpFTO8zUEwIM77BDfG/++XH7D5ih0x2deb0Bm10/JSb8nnzPmtoAdyhlttFUUf738WBJZ5 oOsNHgZ/KrLTZxL+p41JC9Kmk4Bat1XfZ6+4bgOlp5JVeM8TVbEsqmS1TQjeLwa2xZSziL pk3N/aChwiqciGRD+97IIW+4asLb6aQgwnUoI7dI3hELHKW2Tk//SBr1iLCCT+aWkDPvsT FQ+AAIYG1Lg9stK1UYsyMxk/Vho6ncur0PdcvT/RjngmKSYBLRuxCLPHQryuCA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=CBJAoR4C; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.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: -1.30 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=CBJAoR4C; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.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: 0266B203D7 X-Spam-Score: -1.30 X-Migadu-Scanner: scn0.migadu.com X-TUID: R2RwB5Z10G8l 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