From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Clemmer Subject: [doc RFC] Tame the Guix profile blizzard? Date: Mon, 09 Jul 2018 19:40:24 -0400 Message-ID: <87tvp8q8pj.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33517) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fcfle-0005kH-HS for guix-devel@gnu.org; Mon, 09 Jul 2018 19:40:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fcflb-0003Zb-Eu for guix-devel@gnu.org; Mon, 09 Jul 2018 19:40:30 -0400 Received: from mail-qk0-x234.google.com ([2607:f8b0:400d:c09::234]:37864) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fcflb-0003ZT-7z for guix-devel@gnu.org; Mon, 09 Jul 2018 19:40:27 -0400 Received: by mail-qk0-x234.google.com with SMTP id t79-v6so10647358qke.4 for ; Mon, 09 Jul 2018 16:40:27 -0700 (PDT) Received: from sysi37 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254]) by smtp.gmail.com with ESMTPSA id s127-v6sm7847196qkf.80.2018.07.09.16.40.25 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 09 Jul 2018 16:40:25 -0700 (PDT) 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+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel ISTM our doc is a veritable "Profile Blizzard." The term occurs 173 times in guix.texi The "user profile" is referred to in multiple ways: (guix) Application Setup: "your Guix profile" (guix) Features: 'own =E2=80=9Cprofile=E2=80=9D', "per-user profiles", "th= eir profile" (guix) Invoking guix package: "user=E2=80=99s own profile", "user=E2=80=99= s default profile", =E2=80=98$HOME/.guix-profile=E2=80=99 (guix) Invoking guix environment: "package profile" The "system profile" is referred to in multiple ways: (guix) Using the Configuration System: "Globally-installed packages" (guix) operating-system Reference: "global profile", =E2=80=98/run/current-system/profile=E2=80=99 (guix) Networking Services: "system profile" An unnamed type of "environment profile" is produced by 'guix environment' (guix) Invoking guix environment" =E2=80=98GUIX_ENVIRONMENT=E2=80=99 varia= ble An unnamed type of "custom profile" is produced by the 'guix package' -p option. (guix) Top mentions only an entirely different use of the term: * Invoking guix size:: Profiling disk usage. (guix) Concept Index contains only (guix) Invoking guix package references. ISTM we can improve this situation as follows: 1) agree on a canonical term to use for the 4 types of profiles 2) update the doc accordingly 3) add a top level discussion of profiles WDYT? - George