From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id AN2QD70v9GHCpwAAgWs5BA (envelope-from ) for ; Fri, 28 Jan 2022 19:02:37 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id AO5PCL0v9GGehQEAG6o9tA (envelope-from ) for ; Fri, 28 Jan 2022 19:02:37 +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 1281845629 for ; Fri, 28 Jan 2022 19:02:36 +0100 (CET) Received: from localhost ([::1]:49568 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nDVZy-0005o8-QE for larch@yhetil.org; Fri, 28 Jan 2022 13:02:34 -0500 Received: from eggs.gnu.org ([209.51.188.92]:38428) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nDVXY-00057V-DO for guix-patches@gnu.org; Fri, 28 Jan 2022 13:00:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:39316) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nDVXX-000419-9c for guix-patches@gnu.org; Fri, 28 Jan 2022 13:00:03 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nDVXW-0001hH-W7 for guix-patches@gnu.org; Fri, 28 Jan 2022 13:00:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53610] [PATCH] doc: Document --profile option to "guix shell" Resent-From: Konrad Hinsen Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 28 Jan 2022 18:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 53610 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 53610@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.16433927786454 (code B ref -1); Fri, 28 Jan 2022 18:00:02 +0000 Received: (at submit) by debbugs.gnu.org; 28 Jan 2022 17:59:38 +0000 Received: from localhost ([127.0.0.1]:60452 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nDVX8-0001g2-1G for submit@debbugs.gnu.org; Fri, 28 Jan 2022 12:59:38 -0500 Received: from lists.gnu.org ([209.51.188.17]:50422) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nDVX6-0001fu-MG for submit@debbugs.gnu.org; Fri, 28 Jan 2022 12:59:37 -0500 Received: from eggs.gnu.org ([209.51.188.92]:38366) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nDVX5-0004jd-8s for guix-patches@gnu.org; Fri, 28 Jan 2022 12:59:35 -0500 Received: from wnew4-smtp.messagingengine.com ([64.147.123.18]:38051) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nDVX3-0003xY-81 for guix-patches@gnu.org; Fri, 28 Jan 2022 12:59:34 -0500 Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailnew.west.internal (Postfix) with ESMTP id 04EFF2B0041C; Fri, 28 Jan 2022 12:59:30 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute1.internal (MEProxy); Fri, 28 Jan 2022 12:59:31 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.net; h= cc:content-type:date:date:from:from:in-reply-to:message-id :mime-version:reply-to:sender:subject:subject:to:to; s=fm2; bh=0 G9NroC/mq60ecIEZZoaGLN2WYxyNN0R2uNPquN6N5c=; b=YLrwIhwI4AAKje+uW y8SX07Qy+0luW5dGskYa66W5vR+UkQ/2uUwWzQLBi+7eUBzScIIJZVTz4aGb5d8b SLJ35smmnT7MYF2rnnDcTOwW73bEBKvMTAj8aJSjA2fiXvXlLJsiY4O5o1fzMHe+ TaogOgOEtIMagiGNoA9XVovuxdXQ4ch+XZuNMFRid0S8IlcKsRt1LBb8DPmi1T9T FpL7kmChYjteARVNsdIUz/1kiNfzBKwWSV2X1k138um5h3B0MaXmSsoHzGmy5gwJ byp3GIDC1TxehgmnXQA24JmMI6jd5SRa3LxwDqDsK4gjEJpoSxh1ipT/DxEf3wO1 w3ukw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=0G9NroC/mq60ecIEZZoaGLN2WYxyNN0R2uNPquN6N 5c=; b=bTcYbamNqIrzpNA8G5brEpovNNpREQ6VXIs6+iIQQ0dohe+Rmv1gT/hbC EDMz4wc1kG/kV80nxRmsgifJlbyUWUgMhZC1OmNG+wIXIK1bSEkHrP9QVhtCTDWy RXZ5KXC+n+brJWZzVwJp8TP18uNLNRJUOzpEE5sPWh2h3FjYnuAGu3mNnzl5ogGu wwdDCm33mz4vLIJw3jUHLBeLBviHZLaiyU9wn7sg5qHySr5b/e13AgHaYdv49UCD vVDmIgHq1LXpx5pMZMPX3FreBrUVLPhi6Ik0Wu1QBQuA6DSoD0Ti1J32aeySCcqJ qr98Wutj+q3KDXHU9X4azm+l93vvg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvvddrfeehgddutdeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucgovfgvgihtqfhnlhihqddqufhprghmsghothdqkg egvdduqdehudculdeftddtmdenucfjughrpefhvffufffkgggtsehttdertddttddtnecu hfhrohhmpefmohhnrhgrugcujfhinhhsvghnuceokhhonhhrrggurdhhihhnshgvnhesfh grshhtmhgrihhlrdhnvghtqeenucggtffrrghtthgvrhhnpeevfeevuedtiedtteetgfeg hedvudeileekgfehkeehudetveehgeeuteeuveejheenucevlhhushhtvghrufhiiigvpe dtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkohhnrhgrugdrhhhinhhsvghnsehfrghs thhmrghilhdrnhgvth X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 28 Jan 2022 12:59:29 -0500 (EST) From: Konrad Hinsen Date: Fri, 28 Jan 2022 18:59:27 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=64.147.123.18; envelope-from=konrad.hinsen@fastmail.net; helo=wnew4-smtp.messagingengine.com X-Spam_score_int: -8 X-Spam_score: -0.9 X-Spam_bar: / X-Spam_report: (-0.9 / 5.0 requ) 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_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=unavailable autolearn_force=no X-Spam_action: no action 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=1643392956; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:list-id:list-help:list-unsubscribe:list-subscribe: list-post:dkim-signature; bh=0G9NroC/mq60ecIEZZoaGLN2WYxyNN0R2uNPquN6N5c=; b=Kjs4DvXoF+3AlmHDntSCrNXsJVxUUSStvcReiWnuCTg6ia6B4dla02kAdTCrM5YHcG7pal Wr/I3QM0qYnMBMu+BFoGJNmHI7LE4PyimsFOkzLlAq+QeU3ysJ0qq9x48RPY6Y+IVYiJox kKinqYKTwq1I9+2CnlrLKojsiyVQPN66SiQk8YjDi0tqGMKx5HzLM8c5ooZj3VhQjdt70B plHz/jyn84wY1cNSXWnrjotyQMNFECzYUDR98Rzv1nqIhoci4itiKUa5WG2fMYPPyxcWBM KdQ/soKGhekdKZxcRE9TDb1hAuNdecqVYjuYI1TTtGxTkMj1kvyxUZLCQYSycA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1643392956; a=rsa-sha256; cv=none; b=glYuK5+MrvFAePZbXoRuguTEKWISgTOpLVIUnfK9YjvPMMJ/6F65dNadTmUknBI79FQ9vX cjOPFC3iyJppx8d9CA2LAiyrz8lH9cVmRcn/g+AAc9EtbwybRXe7uTLjFJuH8SFXW+/zdG Js21LOMVrlaY+GJCTadz3kwFOKX7bgpZ4PY/0hFXIoBbX9zB7k1qoirBkh1NMeD4gZ3XLh 4VJXTf72B2ljDXXHN6GaiQmt5DZ+Um5zMcZWpUGOA4ulJDDLIHPfaahSPoWG62+qa6bcve xw2X6pW3EGL3mXdCmpNDH8d8gc07fxGkIGMi3oEJKkK3dvS7uwF6L0zYww+ONw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=fastmail.net header.s=fm2 header.b=YLrwIhwI; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b=bTcYbamN; dmarc=fail reason="SPF not aligned (relaxed)" header.from=fastmail.net (policy=none); 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: -2.33 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=fastmail.net header.s=fm2 header.b=YLrwIhwI; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b=bTcYbamN; dmarc=fail reason="SPF not aligned (relaxed)" header.from=fastmail.net (policy=none); 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: 1281845629 X-Spam-Score: -2.33 X-Migadu-Scanner: scn1.migadu.com X-TUID: UItyWPpXybHj * doc/guix.texi (Invoking guix shell): New paragraph. --- doc/guix.texi | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 62e994ceb1..92f515df8f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -5824,6 +5824,12 @@ This is similar to the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files. +@item --profile=@var{profile} +@itemx -p @var{profile} +Create an environment containing the packages installed in @var{profile}. +Use @command{guix package} (@pxref{Invoking guix package}) to create +and manage profiles. + @item --pure Unset existing environment variables when building the new environment, except those specified with @option{--preserve} (see below). This has the effect of -- 2.34.0