From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id +IW+BIgr7GFLvQAAgWs5BA (envelope-from ) for ; Sat, 22 Jan 2022 17:06:32 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id kKdsAYgr7GFoawEAauVa8A (envelope-from ) for ; Sat, 22 Jan 2022 17:06:32 +0100 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 B83F82B1D6 for ; Sat, 22 Jan 2022 17:06:31 +0100 (CET) Received: from localhost ([::1]:43292 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nBIuM-0002px-Vn for larch@yhetil.org; Sat, 22 Jan 2022 11:06:31 -0500 Received: from eggs.gnu.org ([209.51.188.92]:39134) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nBIsx-0002oC-6c for guix-patches@gnu.org; Sat, 22 Jan 2022 11:05:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:44812) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nBIsw-00076l-Rn for guix-patches@gnu.org; Sat, 22 Jan 2022 11:05:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nBIsw-0007IR-NF for guix-patches@gnu.org; Sat, 22 Jan 2022 11:05:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53447] [PATCH] doc: Unset environment variables considered harmful Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 22 Jan 2022 16:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53447 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Liliana Marie Prikler Cc: 53447@debbugs.gnu.org Received: via spool by 53447-submit@debbugs.gnu.org id=B53447.164286747427976 (code B ref 53447); Sat, 22 Jan 2022 16:05:02 +0000 Received: (at 53447) by debbugs.gnu.org; 22 Jan 2022 16:04:34 +0000 Received: from localhost ([127.0.0.1]:37708 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBIsU-0007HA-1Q for submit@debbugs.gnu.org; Sat, 22 Jan 2022 11:04:34 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:56152) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBIsS-0007Gw-DM for 53447@debbugs.gnu.org; Sat, 22 Jan 2022 11:04:32 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 985C31D2; Sat, 22 Jan 2022 17:04:26 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 09pawlt5pIzc; Sat, 22 Jan 2022 17:04:25 +0100 (CET) Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201]) by hera.aquilenet.fr (Postfix) with ESMTPSA id 7CC201A0; Sat, 22 Jan 2022 17:04:25 +0100 (CET) From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: Date: Sat, 22 Jan 2022 17:04:25 +0100 In-Reply-To: (Liliana Marie Prikler's message of "Sat, 22 Jan 2022 15:13:20 +0100") Message-ID: <875yqb21va.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: / X-Rspamd-Server: hera X-Rspamd-Queue-Id: 985C31D2 X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; FREEMAIL_ENVRCPT(0.00)[gmail.com]; TO_MATCH_ENVRCPT_ALL(0.00)[]; TAGGED_RCPT(0.00)[]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_TWO(0.00)[2]; FREEMAIL_TO(0.00)[gmail.com]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1642867591; 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; bh=2HLh+MkzBk1WjjQ59vCtBd/MLYynTipswJul4MagXW8=; b=EmW/bl5IA67OrUkhVrfOJa4luYDWPnaOw8WAneWFpSi4F9ld363zCVXbcamclTLpoz2SNv ed1r9IJCmDlEuKqj9MN2yzIH2p8Oi0ncuMsxH68/DMaSqFGe6dECNutnO2P/0kflNwReIt 3LdLOdwb+ytQh6/r3XbNY6Qa7MjHh76vV5HzLJTI+kmx2Xa7SwXtWhY1JDFnEFPFU+rSuX MuW+5OMWIZR6T2/8rgInNpT18NE70rKcJSeINrHEWo1lDHzLiNekwVDrfVBsoyuQgKiFlS CHKc/Rq+m6/45Df111Z7WmnT0XRpx8NY2qBWkyLzbEkcf9fjnCoUjD/FxyFlug== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1642867591; a=rsa-sha256; cv=none; b=R84wJj7JYr9dWebl4sK9BbcxgD+CRkG2L2UhQ4vv0xvyvcVzOVGxAtWtXatsh55fuN2TPj e1aZFMcNR8B5jy7N8lrs/or0e5IRL8wYjkawUTzfwBzChMz4zFA9PKEypE8jM6GtcVgwlj efiJO+eI9fcrcVKXo2nwoGd+Hq9zu3LwwBbwGXwVgNDtyxuSEvrc9VbU6YsY8VsPOlmvmw gfp3UyVuPlY0Q+4ZkA/CyjMo94BqLORtPX0UGmt3PaGytZlhnQAb7DlyJrmyBOWr6Lw5sT PGu3/NSIJRFU0H+uBjVM8dybZiwG3lb87fqqLIg6owk1gNNrZoHMepPWVoUy4g== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.63 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: B83F82B1D6 X-Spam-Score: -3.63 X-Migadu-Scanner: scn1.migadu.com X-TUID: V4vSjJo4Vvtl Hi Liliana, Liliana Marie Prikler skribis: > * doc/guix.texi (Application Setup): Add subsection for implicit environm= ent > variables. > --- > doc/guix.texi | 27 +++++++++++++++++++++++++++ > 1 file changed, 27 insertions(+) > > diff --git a/doc/guix.texi b/doc/guix.texi > index 912a8e3c5a..805e3b611f 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -2023,6 +2023,33 @@ want to avoid auto-loading the Emacs packages inst= alled with Guix, you > can do so by running Emacs with the @option{--no-site-file} option > (@pxref{Init File,,, emacs, The GNU Emacs Manual}). >=20=20 > +@subsection Implicit Environment Variables > + > +Many environment variables are defined in a way that assumes a certain > +default value, even if unset. For example, bash uses the current > +working directory as @env{PATH} if unset, or @env{XDG_CONFIG_HOME} > +expands to @file{$HOME/.config}. Some of these defaults remain the same > +whether a package is used through Guix or not---however, environment > +variables referring to @file{/etc} or @file{/usr} typically have their > +meaning subtly changed in Guix. An application installed via Guix might > +instead look up files in its own @file{etc} structure, or (if a > +search-path was specified) even override the default for packages from > +the foreign distro. I think I miss some context: what concrete problem is this trying to solve? What is it telling me to do? I wonder to what extent this is actionable for a user, due to wording that leaves it up to the reader to figure out how this applies to them: =E2=80=9CMany environment variables=E2=80=9D =E2=80=9Ca certain default value=E2=80=9D =E2=80=9CSome of these=E2=80=9D =E2=80=9CAn application installed via Guix might=E2=80=9D =E2=80=9Cproblems coming from such implicitly defined=E2=80=9D =E2=80=A6 I think the =E2=80=9CApplication Setup=E2=80=9D section should be as concre= te as possible, with clear instructions (=E2=80=9CIf X then type Y=E2=80=9D), pos= sibly followed by explanations that curious readers can read and that others can skip. WDYT? Ludo=E2=80=99.