From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id ADnnDL0OZ2G4GgAAgWs5BA (envelope-from ) for ; Wed, 13 Oct 2021 18:52:13 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id cDpcCL0OZ2HbVAAAbx9fmQ (envelope-from ) for ; Wed, 13 Oct 2021 16:52:13 +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 B168129D45 for ; Wed, 13 Oct 2021 18:52:12 +0200 (CEST) Received: from localhost ([::1]:60400 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mahUB-0004On-Ju for larch@yhetil.org; Wed, 13 Oct 2021 12:52:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:49362) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mahU2-0004Mf-PD for guix-patches@gnu.org; Wed, 13 Oct 2021 12:52:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:49916) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mahU2-0001K1-Bn for guix-patches@gnu.org; Wed, 13 Oct 2021 12:52:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mahU1-0006lf-TG for guix-patches@gnu.org; Wed, 13 Oct 2021 12:52:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#50960] [PATCH v2 03/11] Add 'guix shell'. Resent-From: "pelzflorian (Florian Pelz)" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 13 Oct 2021 16:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50960 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 50960@debbugs.gnu.org, Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 50960-submit@debbugs.gnu.org id=B50960.163414388225967 (code B ref 50960); Wed, 13 Oct 2021 16:52:01 +0000 Received: (at 50960) by debbugs.gnu.org; 13 Oct 2021 16:51:22 +0000 Received: from localhost ([127.0.0.1]:33229 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mahTN-0006kk-V4 for submit@debbugs.gnu.org; Wed, 13 Oct 2021 12:51:22 -0400 Received: from pelzflorian.de ([5.45.111.108]:38090 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mahTI-0006kY-22 for 50960@debbugs.gnu.org; Wed, 13 Oct 2021 12:51:21 -0400 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 885A5360AEE; Wed, 13 Oct 2021 18:51:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1634143874; bh=FvsGab3aUgbRRY7qAK5wz75NR5kwEaoWqzQhj0yMbdw=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=Vo/6jzeEaDDM7ZnBcCn6y2rRm9+G6hQE6tbFupQdN04C2iFsrG1RAnr8HKvyrB8Xq T1neBdZIZu56s97LyVCd9VeFmGmsw5PVD8vc4lr0avU8WmMOxQ5Fx1m5lC/SI4kNdd 2a9IJEy34FDZw+304a+VBcIyUF5CpFUEVLu5z7/Y= Date: Wed, 13 Oct 2021 18:51:04 +0200 From: "pelzflorian (Florian Pelz)" Message-ID: <20211013165104.nlzlz7npsxcpbsjn@pelzflorian.localdomain> References: <20211002102116.27726-1-ludo@gnu.org> <20211011213809.17482-1-ludo@gnu.org> <20211011213809.17482-4-ludo@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20211011213809.17482-4-ludo@gnu.org> 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 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1634143932; 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=tGdMGaBzY1b0ayFlyZ6oFcppE9kFqifibj2KWsClV10=; b=OrAiroSTHAKfHqtMnAmaNz+Hp6vQO18HjS7Qe7/rhuf3McLHB4swNg13e48yOVVqANzR72 7hbiyEGAWCsEEeXmLkY8daj0kajFMubj9kohYjKvY1Y1PcV9Uumr1cAChO+DegIHAVKA9P Ds0lunBZpCyhL9iA/C+MZG4L5TQNhiFv/Rr5qvbOc1Dv4p93O3CmBljS+73obP+NcDndMF +Iaq8c8RbbMoh5QivS1084BlXN5PHVPjYC6A76FPZimDjdQ5Lg5XWR63xwjPZzf+08b87f ALKVySK0x2yDBaUPl6I00mOpJGEtOGHRxqJ+MiseTPvM5WzjQOkixHicUmSSYg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1634143932; a=rsa-sha256; cv=none; b=j8/UP+UUccsaqdfHp2ghk1OOqyRet+WMX8qI8117w9nnlSMdjhpuoFLYQOLFCXAnW0zIkw 3golWVj043PpaRSJxhhHpj7OmYhXHxwN7SpwCw5SyfHCrNh3fUR4ac+H7KTFaS3T+6m5O7 gmCYkwPOLiATSqx2KWGt+Qku0RY4d9KeJZnoydjZCcAFWAKQpAp5xQ5EpYzB5jgYkRTw4i oDhdxeCwKUXqsngAI80oQMQkG8vVeM9joxTGsmv9vAdOdZ+TMhqefowmpv3lgTfv/u6XCW JoxMYjNeZwwHirzH6zsTSjBWozkUx3yggXEaeGSZiLE5oMvaR8VM+lt5pq8cHg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=mail header.b="Vo/6jzeE"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: -1.82 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=pelzflorian.de header.s=mail header.b="Vo/6jzeE"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: B168129D45 X-Spam-Score: -1.82 X-Migadu-Scanner: scn1.migadu.com X-TUID: 1dvJdeZPXIuo Hello Ludo! When I pull, I can’t use guix shell, perhaps because you did not add it to guix/self.scm? I like that the new documentation does not target only developers and hackers. On Mon, Oct 11, 2021 at 11:38:01PM +0200, Ludovic Courtès wrote: > […] > +The general syntax is: > + > +@example > +guix shell [@var{options}] [@var{package}@dots{}] > +@end example > + > +The following example creates a environment containing Python and NumPy, *an* environment > +building and downloading any missing package, and runs the building *or* downloading > […] > +By default, the shell session or command runs in an @emph{augmented} > +environment, where the new packages are added to search path environment > +variables such as @code{PATH}. You can, instead, choose to create an > +@emph{isolated} environment containing nothing but the packages you Hmmph. I had seen the words “isolated environment” being used to describe containers in "(guix)Managing Software the Guix Way". Therefore I also had used the German term for “isolated” to explain containers in other parts of the manual. Probably this was not necessary; if you apply guix shell with this term, I will change all occurrences of “isoliert” in the German PO files. But then again, maybe it would be better if you described pure environments not as isolated. I also see a mix-up further below: > +This @option{--container} option can also prove useful if you wish to > +run a security-sensitive application, such as a web browser, in an > +isolated environment. For example, the command below launches > +Ungoogled-Chromium in an isolated environment, this time sharing network > +access with the host and preserving its @code{DISPLAY} environment > +variable, but without even sharing the current directory: > + > +@example > +guix shell --container --network --no-cwd ungoogled-chromium \ > + --preserve='^DISPLAY$' -- chromium > +@end example > […] Back to typos: > +@node Invoking guix environment > +@section Invoking @command{guix environment} > + > +The purpose of @command{guix environment} is to assists in creating is to *assist* So much for the docs. I have not looked further. Regards, Florian