From patchwork Fri Jan 28 17:59:27 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Konrad Hinsen X-Patchwork-Id: 36862 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 1A2FA27BBE9; Fri, 28 Jan 2022 18:02:39 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 6E86B27BBEA for ; Fri, 28 Jan 2022 18:02:38 +0000 (GMT) Received: from localhost ([::1]:49568 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nDVa1-0005o8-Dj for patchwork@mira.cbaines.net; Fri, 28 Jan 2022 13:02:37 -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 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+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches * 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