GNU bug report logs - #61094
[PATCH] doc: Document 'shebang' for 'guix shell'.

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Package: guix-patches; Reported by: Simon Tournier <zimon.toutoune@HIDDEN>; Keywords: patch; Done: Ludovic Courtès <ludo@HIDDEN>; Maintainer for guix-patches is guix-patches@HIDDEN.

Message received at 61094-done <at> debbugs.gnu.org:


Received: (at 61094-done) by debbugs.gnu.org; 16 Mar 2023 11:22:13 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Mar 16 07:22:13 2023
Received: from localhost ([127.0.0.1]:41371 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pclgT-0002Cv-AN
	for submit <at> debbugs.gnu.org; Thu, 16 Mar 2023 07:22:13 -0400
Received: from eggs.gnu.org ([209.51.188.92]:38164)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1pclgO-0002Cc-2Q
 for 61094-done <at> debbugs.gnu.org; Thu, 16 Mar 2023 07:22:11 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <ludo@HIDDEN>)
 id 1pclgI-0007ao-PW; Thu, 16 Mar 2023 07:22:02 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To:
 From; bh=mWX1RbfGd5d8tUXV5jzkDo0S+JjU0NyY+KILlPXDQTw=; b=AEePgdH1incquDCAllyU
 0XaUwUyzlxtXoKTKpG8lj+q0JpQRiBPsNe/8qy33Zi+8gF4ITgimlrcLaJrj9/a7lvZRIdsjSMgZ0
 HUJPodTNy75LvbPuYT0S6vihGH2ziWF1M5gYPj9WrWfob2zXB3allAzX0233kXm214xWy3Oa7a5Dd
 rbIwjYcnSj112lkR0wB++jZyGK70GX2lVGMzH4czmea4NRdH9i2EexK4YqJ0xV/DFcmcHCJD0T/PN
 q9TacBrlHqsNxQa61w25IvQBjLyfrVX7l7Edl0iWGWHyj8mW0VCrmNMRdOFVdVKIZz1GvaSgHVaIS
 Q0h+ViepkfsFvw==;
Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <ludo@HIDDEN>)
 id 1pclgH-0000mM-2E; Thu, 16 Mar 2023 07:22:02 -0400
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@HIDDEN>
To: Simon Tournier <zimon.toutoune@HIDDEN>
Subject: Re: bug#61094: [PATCH] doc: Document 'shebang' for 'guix shell'.
References: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
Date: Thu, 16 Mar 2023 12:21:59 +0100
In-Reply-To: <20230127111237.2910126-1-zimon.toutoune@HIDDEN> (Simon
 Tournier's message of "Fri, 27 Jan 2023 12:12:37 +0100")
Message-ID: <87v8j1eyaw.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 61094-done
Cc: 61094-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable

Hi Simon,

Simon Tournier <zimon.toutoune@HIDDEN> skribis:

> * doc/guix.texi (Invoking guix shell): Add a note mentioning how to use
> 'shebang'.

Applied with the changes below.=20=20

Thanks!

Ludo=E2=80=99.


--=-=-=
Content-Type: text/x-patch
Content-Disposition: inline

diff --git a/doc/guix.texi b/doc/guix.texi
index 9c1fc04265..aa98d7df4b 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -5940,16 +5940,19 @@ guix shell python python-numpy -- python3
 @end example
 
 @quotation Note
-@cindex shebang
-@command{guix shell} can be used as @emph{shebang}.  Consider the
-previous example as an executable Python script, the @emph{shebang}
-reads,
+@cindex shebang, for @command{guix shell}
+@command{guix shell} can be also be used as a script interpreter, also
+known as @dfn{shebang}.  Here is an example self-contained Python script
+making use of this feature:
 
 @example
-#!/usr/bin/env -S guix shell python python-nympy -- python3
+#!/usr/bin/env -S guix shell python python-numpy -- python3
+import numpy
+print("This is numpy", numpy.version.version)
 @end example
 
-All the @var{options} or convenience of @command{guix shell} apply.
+You may pass any @command{guix shell} option, but there's one caveat:
+the Linux kernel has a limit of 127 bytes on shebang length.
 @end quotation
 
 Development environments can be created as in the example below, which

--=-=-=--
Notification sent to Simon Tournier <zimon.toutoune@HIDDEN>:
bug acknowledged by developer. Full text available.
Reply sent to Ludovic Courtès <ludo@HIDDEN>:
You have taken responsibility. Full text available.

Message received at 61094 <at> debbugs.gnu.org:


Received: (at 61094) by debbugs.gnu.org; 16 Mar 2023 11:09:23 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Mar 16 07:09:23 2023
Received: from localhost ([127.0.0.1]:41356 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pclU3-0007vn-0L
	for submit <at> debbugs.gnu.org; Thu, 16 Mar 2023 07:09:23 -0400
Received: from eggs.gnu.org ([209.51.188.92]:60258)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1pclU1-0007vZ-JZ
 for 61094 <at> debbugs.gnu.org; Thu, 16 Mar 2023 07:09:21 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <ludo@HIDDEN>)
 id 1pclTu-00027L-OT; Thu, 16 Mar 2023 07:09:15 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To:
 From; bh=i1SEbHgSMM6P+ZegkjM/TEKJniblv/ktYRAKrSb9rLc=; b=PI6fHLpcd4/Cy77ujD8B
 HyH8PcQ+C4KxjF7AQKX+BX8mZpC+wM7/AODUrsZrS1SvJn99SvG0osaQmgW87WRzc14dLjDWOJZms
 f5vIA8N8mvHYmhk6Lid1t8Uu7Lpzrlxes0KIHM3shkqwnKoUC4PjU4Bg+8LIFrZtmp7WW1/uqBUzd
 lAVUQWXTbWWeN7ZpvqlA+sh/NHPNbVWaKxvZnbkqHsUzSQtF0btRtQNEZUQOae/CNQOJ1j6X2cdfO
 TRUVuYaA+RMo1VEA3biKh3AMPFPD9fO45BS8tRPwS8JmGBLKblID/JVyaFj6ty5dGRak/YB6Ex6wy
 M8GJ1ahpgZkcew==;
Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201] helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <ludo@HIDDEN>)
 id 1pclTt-0007S5-V6; Thu, 16 Mar 2023 07:09:14 -0400
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@HIDDEN>
To: Morgan Smith <Morgan.J.Smith@HIDDEN>
Subject: Re: bug#61094: [PATCH] doc: Document 'shebang' for 'guix shell'.
References: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
 <8e79fe217c633650394f2c5199e94e5d0c5a7911.camel@HIDDEN>
 <86v8kdn1ax.fsf@HIDDEN>
 <DM5PR03MB3163BD454A5535BB756DA4D8C5D99@HIDDEN>
Date: Thu, 16 Mar 2023 12:09:11 +0100
In-Reply-To: <DM5PR03MB3163BD454A5535BB756DA4D8C5D99@HIDDEN>
 (Morgan Smith's message of "Thu, 09 Feb 2023 11:07:19 -0500")
Message-ID: <87zg8deyw8.fsf_-_@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 61094
Cc: 61094 <at> debbugs.gnu.org, Liliana Marie Prikler <liliana.prikler@HIDDEN>,
 zimoun <zimon.toutoune@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Hi,

Morgan Smith <Morgan.J.Smith@HIDDEN> skribis:

>>>> +@example
>>>> +#!/usr/bin/env -S guix shell python python-nympy -- python3
>>>> +@end example
>
> Apparently, according to POSIX you're only allowed one argument on the
> '#!' line after the path of the executable.  I haven't confirmed this
> myself but it is in the guile manual, section 4.3.2 "The Meta Switch".
>
> One argument does seem quite limiting though so I wonder if anyone
> actually imposes that limit.

Yes, and =E2=80=98env -S=E2=80=99 is used to work around that limitation by=
 splitting
that one argument.  It=E2=80=99s a GNU extension, which is fine in this con=
text.

Ludo=E2=80=99.
Information forwarded to guix-patches@HIDDEN:
bug#61094; Package guix-patches. Full text available.

Message received at 61094 <at> debbugs.gnu.org:


Received: (at 61094) by debbugs.gnu.org; 9 Feb 2023 16:07:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Feb 09 11:07:24 2023
Received: from localhost ([127.0.0.1]:33394 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pQ9SG-00013T-0e
	for submit <at> debbugs.gnu.org; Thu, 09 Feb 2023 11:07:24 -0500
Received: from mail-bn8nam12olkn2073.outbound.protection.outlook.com
 ([40.92.21.73]:11915 helo=NAM12-BN8-obe.outbound.protection.outlook.com)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <Morgan.J.Smith@HIDDEN>) id 1pQ9SD-00013E-Tu
 for 61094 <at> debbugs.gnu.org; Thu, 09 Feb 2023 11:07:22 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;
 b=OLzP3Sjiml+wBaz8ouLiSea8UG4nlLBNKK+b7w9m28bdFVfb4HGjXQlKbVs9bbLOQjtIECLtg/0chJvhaXM3RN+qqVD9jyyx3Ky0Vw3L+RxRkMOJeUu6OutbF4Reohc/i8AD6QLF/ZovM3tukBN02M21fVe+AErUSb7aCS3Z6KCPwpY+vzbfSPxobkHidmNTHWijeNERKdM8lTrR487rSObpiGzVv1Go9LJ3mGUkkthi+4Asz1FcvGDwdOpT5QQ8UMGITnty2O7wwKuHr6ZVfsTw4qMZe8lFIKkjmhO3+2R5iRPynn3IqUEBsPzYcFpTWfecg1LE0uWxftBJB0/ZUw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector9901;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;
 bh=GLIDhbqdpjk84vFkSkqlbGpfQsX6CjprENEfVofAEI8=;
 b=nU7PiiHlpU3qfETNL/lEAwULFapdy5cwSaZnh9zhDVRYShan+QJ1hPtiIJA4pW+VBW0vYIyqXKlZ8LuODHaBHuPxMoG6opUnFngvrlnNBgjhAkYINMGBo6xUJJZcT2rgLPfKySjzuTwSLp9ZKeS9toiNpTBgItRRO7FV5tscWv6R1TSAzuDsVXbdvqm8kRGfh8TzssvKF6JmATlzJv8sWZ7CsdNKy0Os5wW95QUfhySK2MbdEidXbcu7R8aVccDRct2sm4sBnce04qG/RiNSPM68CsmSuqx5LX+mFTwlmbQekrP3l88OkNt1kKiNS9uYpWFHnfppXd/1axMg4yYa1Q==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none;
 dkim=none; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com;
 s=selector1;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=GLIDhbqdpjk84vFkSkqlbGpfQsX6CjprENEfVofAEI8=;
 b=LbWWvSlNuG3emhy1O/rdT4EqscyhXoJ9YepBn2zoYvQwdGBtwDzQTy3zxpIRI0CZ1ZroyPTE8nGnIzEJeaBjqV0ZAhp6DWSnMyK99N0wmBujUNkDLHewlZcxvep7tITQ8A2SHv+udvgti++niX0zCUY7CszUs/egcJp+Q7dvYUqJXDHO9BAMqR6QPbm6bAKdm/lIgAgKiCsfYkaVw1Wggc3tCDd+5LW6QR//Cgo1B0Isht/a45Zfpj3NiR+e9tiXcE67iE0jpa334MkIFi8x7YQa3apqpokmsWTrGUq7ppQmnLU9RTNyuv5Hvi0TVlUWfEzrHr20MFeVlakRLjvCMg==
Received: from DM5PR03MB3163.namprd03.prod.outlook.com (2603:10b6:4:40::24) by
 BN8PR03MB5105.namprd03.prod.outlook.com (2603:10b6:408:d7::11) with
 Microsoft
 SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id
 15.20.6086.19; Thu, 9 Feb 2023 16:07:15 +0000
Received: from DM5PR03MB3163.namprd03.prod.outlook.com
 ([fe80::9d7c:7c0a:3e89:57dc]) by DM5PR03MB3163.namprd03.prod.outlook.com
 ([fe80::9d7c:7c0a:3e89:57dc%7]) with mapi id 15.20.6043.033; Thu, 9 Feb 2023
 16:07:15 +0000
From: Morgan Smith <Morgan.J.Smith@HIDDEN>
To: zimoun <zimon.toutoune@HIDDEN>
Subject: Re: bug#61094: [PATCH] doc: Document 'shebang' for 'guix shell'.
In-Reply-To: <86v8kdn1ax.fsf@HIDDEN> (zimoun's message of "Tue, 07 Feb 2023
 12:48:54 +0100")
References: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
 <8e79fe217c633650394f2c5199e94e5d0c5a7911.camel@HIDDEN>
 <86v8kdn1ax.fsf@HIDDEN>
Date: Thu, 09 Feb 2023 11:07:19 -0500
Message-ID: <DM5PR03MB3163BD454A5535BB756DA4D8C5D99@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
Content-Type: text/plain
X-TMN: [UmXkifowBXT8TH+hVgEZtaMyjHaHOrM/]
X-ClientProxiedBy: YT3PR01CA0039.CANPRD01.PROD.OUTLOOK.COM
 (2603:10b6:b01:82::16) To DM5PR03MB3163.namprd03.prod.outlook.com
 (2603:10b6:4:40::24)
X-Microsoft-Original-Message-ID: <87pmaistzc.fsf_-_@HIDDEN>
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: DM5PR03MB3163:EE_|BN8PR03MB5105:EE_
X-MS-Office365-Filtering-Correlation-Id: 3a1bcb1d-e6cb-4d0b-abe9-08db0ab7b5bc
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: eqtuFt82bhxIgpl0WhROhaiVXZo3zBNuPtyv8+Pir3of2bfv3gOXpc09WeQadG5ErDw1tF/wNCDI/8Cs40m9sZLeNA5ESiJt9WxqdZ79MIF0N5CUX21Svt2SMTUIi+onUy21twL0vKOE0pRfVWRd+7jydmvC1Ls7Ypiy1qJrwvHJt8DXL0YaYFylWxGd26Kk0z88gURYsOfKGKGGBcQWvm2B2of1kzlG+X+m3Fgw362X1KnG43YXJ89EFhzip1Y1RBeZSb2LleqopYI5U90iD7G7IVXQf95cmxkXvBCDrMzm7BVFQDMJMbSM9/bYAwoGmzuCPMMhHbHXBrEvj2TjLPkmX2sRl9cstkjoY0W25P/T2dzLqu83lusqLmcIwFt1keQWn8tSeaVXVHbpWX+4byIE5DYWC17L5hRPMwpYp8Zu7LwD2+baFTzNranJLFjRE1+RXERUoL5nKlSSB3I5fTyib0bEcDSJkTHljeRP/uPhM3ynnFsgHeNN29Irv5Cumkm+lBhW9ZvHm5hDci3f4LwXtMPgbk44SB+Wyt9SeFYWo7gRZn5GXAqokVhzL+OMEgG9vHfOurNO9SMh31gbXAZFOgJES/3Msy24QKgZdnkGBZkYJZa8gwk1Fs6FebbZMhXje4M6cmVSzb55ZVfRdg==
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?hLBbjltPWb2opOWrL4fvY0kfHCPGItJzLXRPeTKdOeX5rFwb4E37yisVAwXN?=
 =?us-ascii?Q?1E3wL5MitaO3ysp5E9pDXxd9HVYPgc5q1a5i8SKZ9/Zbd7AXb4SzzsIFxhZ8?=
 =?us-ascii?Q?FYR8HC4XJBIYkoVFwgXMAScbX755sVNYLR7ShH4eQU/qz3z2yVV12EtURwEN?=
 =?us-ascii?Q?rFzEpz54GKID4//c+OVqojv1bUOITCAMxmm4uoQmPfydYltLrfjRz8yWDCsJ?=
 =?us-ascii?Q?6fLi88rwOUX2jPYUqLbV0vLCZSUffVxt7dnWzcLlKoeOER/oM36X0EaXhfZD?=
 =?us-ascii?Q?0iLtVG+PRNPzC1iCE3yS+oi3hwJ+J7yWcvF+lon0RKFnEJNAGHgZv1q0IaqT?=
 =?us-ascii?Q?FCwIePPmxTZ1cn7ELEPirPD32OlU/aYgt3fysWWrv8e0cSRmvbr9bOP3w1Dw?=
 =?us-ascii?Q?3uZeosTsKJBDCo/2rupeQoFnsLecBO9MJguMEJArXPvP4LC7ZhVi6unXLqx+?=
 =?us-ascii?Q?cpv8DMkF+eEoHpfEQ0mfXmp5xl/oAGyLoMisY2pqIcQXQQia7w0X49e9js8u?=
 =?us-ascii?Q?x/5ZArMaprAghQHjtyrhDabKbUIn1ogUyaqirvTeym1lTJJTlgHBAqrIAh/Z?=
 =?us-ascii?Q?h7RxnF9wwhuSPfX5rzQ5jzsL2kLNOpPiQEF28hw4g/BbD7ua6Z0sygRWbaKI?=
 =?us-ascii?Q?UN3tMetkHEdZN0jkPxlZyvG/uh5118IHChBgZhFCbn/0cdicUpzuMxIEXrTq?=
 =?us-ascii?Q?JMUGdsDAMWOm/TeYgvE7/x6WzRPZ4zkfRjIMoOy6bsJTCcvQ7cV2Pbb0g/3r?=
 =?us-ascii?Q?3k74f8G/RvQrBndZQ/fwkqTCwnmcPdH43yLr2Ihe+LUpSks6zGC68JeuapO8?=
 =?us-ascii?Q?MzeNvBelCYUBMlAFo9sf0epb6icacM7bPtXPA9pNIYB5YF2jtPmU6M0D7Zp+?=
 =?us-ascii?Q?Z+ir/xdNx0IJwef9t3CJzyUvdsdpLac8yMhAEFzNKTrf9kLAlgWaPv7seVHM?=
 =?us-ascii?Q?EMygOJikGRrnQtNDS+hbKqxU/CXsgdnxL0QfBxm6sxBweE/6t/uQcMC28m6+?=
 =?us-ascii?Q?E7tZ9fHbKHggEx83jiJ8jj+8iPv0pNuTILstxtYLT4NypM9yIwBVccYHzmpm?=
 =?us-ascii?Q?6qIQ8G6V6bx3VWzoaUPyVp75thpUUY5EymukIHXXodTS/HvIRVI6YQFeHOuj?=
 =?us-ascii?Q?79B8HhpM5gSEASKjIDKZjGW/vnZpCt8rxtoovvERh0pUKrhNCCGEOL8s15Tq?=
 =?us-ascii?Q?us8oRXBfqYW4yVRwTDSTxaApBH64X7JA5k6DsfUTQIEjg+BpXF17y3wYictu?=
 =?us-ascii?Q?fSo/hK+ISrlZ91ahb2xdmLEm5BMty9GXoXdysDngP9SGoE6SrrZ+x9TYyGwe?=
 =?us-ascii?Q?r1o=3D?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 3a1bcb1d-e6cb-4d0b-abe9-08db0ab7b5bc
X-MS-Exchange-CrossTenant-AuthSource: DM5PR03MB3163.namprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Feb 2023 16:07:15.1765 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN8PR03MB5105
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 61094
Cc: Liliana Marie Prikler <liliana.prikler@HIDDEN>, 61094 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Hello,

>>> +@example
>>> +#!/usr/bin/env -S guix shell python python-nympy -- python3
>>> +@end example

Apparently, according to POSIX you're only allowed one argument on the
'#!' line after the path of the executable.  I haven't confirmed this
myself but it is in the guile manual, section 4.3.2 "The Meta Switch".

One argument does seem quite limiting though so I wonder if anyone
actually imposes that limit.


Morgan
Information forwarded to guix-patches@HIDDEN:
bug#61094; Package guix-patches. Full text available.

Message received at 61094 <at> debbugs.gnu.org:


Received: (at 61094) by debbugs.gnu.org; 7 Feb 2023 11:59:03 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Feb 07 06:59:03 2023
Received: from localhost ([127.0.0.1]:51388 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pPMcp-000390-3G
	for submit <at> debbugs.gnu.org; Tue, 07 Feb 2023 06:59:03 -0500
Received: from mail-wm1-f41.google.com ([209.85.128.41]:34463)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <zimon.toutoune@HIDDEN>) id 1pPMcn-00038J-Jl
 for 61094 <at> debbugs.gnu.org; Tue, 07 Feb 2023 06:59:01 -0500
Received: by mail-wm1-f41.google.com with SMTP id
 f23-20020a05600c491700b003dff4480a17so757177wmp.1
 for <61094 <at> debbugs.gnu.org>; Tue, 07 Feb 2023 03:59:01 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:references
 :in-reply-to:subject:to:from:from:to:cc:subject:date:message-id
 :reply-to; bh=Er6Iy+p5ARJwgcVU1iJ7XUBhMIoC1YMGDf5+O3rDddo=;
 b=GMCcVIIT5F3CkKs5fkyOJRYOFa38eRjZnFZHjUoN8kmCPeY9NGFbdSopyAqcIPmvFl
 F53ep8kqs0i9RSFBnbjpSO24rKyovqfpzLzoKMtJfnb7AUqZM8FIvcWhWNXXxHn60LXI
 tETzM4g+/gKOIZZjPbEnEi4DajYOLjQjijgYqFI57U42VsDWdbOC4Im/G4f2iiO0GrDK
 8OUWjgqK8+GYqJO+amYIY1I998WFtnRS3QM/HjdkQobM0IgjFwADiKjG99AopK0xdizm
 1JjukefOq9GsbjZOadNLBK/6foJQwEmx5ISmjTFclYTNC3yRn0xjMwSifO563MHKuzL7
 P77g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:references
 :in-reply-to:subject:to:from:x-gm-message-state:from:to:cc:subject
 :date:message-id:reply-to;
 bh=Er6Iy+p5ARJwgcVU1iJ7XUBhMIoC1YMGDf5+O3rDddo=;
 b=ViHEVGNbPLMQjt27UPjIlTHYMPEDloXVkEDor1ZKJQqBmvQY7PR+Ghb9J8Z6SB7b52
 57ZF8oYiIWXh3KUjKjSZ9j8NxQ5PHW70f9cTHYKq5vYiBJmAO5wIQ4nFuiKGTxXG0a12
 IWVyda8ywqDQmRgmcdNCh15r6boSdK19TM713QS30GRBggfk+M52DhbsBVWy2E8SeZkQ
 BXatPJ166mYfU7L/9HBng9qwHSVconJzg5G7T06LFswZ4JREV+j0CuvZZrmC0AljvGfZ
 +O/6lntAL2T4N3V3FK6/Mr1iDpS8zaZnRmMOOZmi36g2vpLAl/Sbi6cwU+vjKVafP0eW
 eqHA==
X-Gm-Message-State: AO0yUKV5R0zU0yOoV2J1oqQauhpnDXAsqq6kV9bdnhCXSX72gd3CypRl
 z+oCtI4GIajBzjgBXm5L2S8fOyn6eusHYg==
X-Google-Smtp-Source: AK7set8JrBuGb+IKuC5Veh9Hk02OvBGS9IqIIz0NJAohSltqa4exppTqrpq8JCx+8uhdOYN4h9WtiQ==
X-Received: by 2002:a05:600c:3106:b0:3dd:1cd3:5d75 with SMTP id
 g6-20020a05600c310600b003dd1cd35d75mr3574857wmo.0.1675771135889; 
 Tue, 07 Feb 2023 03:58:55 -0800 (PST)
Received: from lili ([81.255.72.129]) by smtp.gmail.com with ESMTPSA id
 bi5-20020a05600c3d8500b003db012d49b7sm2102914wmb.2.2023.02.07.03.58.55
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Tue, 07 Feb 2023 03:58:55 -0800 (PST)
From: zimoun <zimon.toutoune@HIDDEN>
To: Liliana Marie Prikler <liliana.prikler@HIDDEN>, 61094 <at> debbugs.gnu.org
Subject: Re: [bug#61094] [PATCH] doc: Document 'shebang' for 'guix shell'.
In-Reply-To: <8e79fe217c633650394f2c5199e94e5d0c5a7911.camel@HIDDEN>
References: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
 <8e79fe217c633650394f2c5199e94e5d0c5a7911.camel@HIDDEN>
Date: Tue, 07 Feb 2023 12:48:54 +0100
Message-ID: <86v8kdn1ax.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 61094
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Hi,

On Fri, 03 Feb 2023 at 23:54, Liliana Marie Prikler <liliana.prikler@gmail.=
com> wrote:

>> +@quotation Note
>> +@cindex shebang
>> +@command{guix shell} can be used as @emph{shebang}.=C2=A0 Consider the
>> +previous example as an executable Python script, the @emph{shebang}
>> +reads,
>> +
>> +@example
>> +#!/usr/bin/env -S guix shell python python-nympy -- python3
>> +@end example
>> +
>> +All the @var{options} or convenience of @command{guix shell} apply.
>> +@end quotation
>> +
>
> Is this really guix running as a shell or is it actually a feature of
> env?  In either case, it's worth documenting, but we should try to stay
> factually correct.

Well, I am not sure to understand the question.  It is a feature of env
which allows to run =E2=80=9Cguix shell=E2=80=9D which provides python3 as =
=E2=80=9Cshell=E2=80=9D.

From my understanding, all written seems factually correct.  Maybe I am
missing something and I would be happy to be corrected if I am doing
wrong. :-)

Cheers,
simon
Information forwarded to guix-patches@HIDDEN:
bug#61094; Package guix-patches. Full text available.

Message received at 61094 <at> debbugs.gnu.org:


Received: (at 61094) by debbugs.gnu.org; 3 Feb 2023 22:54:49 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Feb 03 17:54:48 2023
Received: from localhost ([127.0.0.1]:40152 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pO4xE-0006B4-MB
	for submit <at> debbugs.gnu.org; Fri, 03 Feb 2023 17:54:48 -0500
Received: from mail-ej1-f67.google.com ([209.85.218.67]:35627)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <liliana.prikler@HIDDEN>) id 1pO4xC-0006Aq-KG
 for 61094 <at> debbugs.gnu.org; Fri, 03 Feb 2023 17:54:47 -0500
Received: by mail-ej1-f67.google.com with SMTP id qw12so19446643ejc.2
 for <61094 <at> debbugs.gnu.org>; Fri, 03 Feb 2023 14:54:46 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=mime-version:user-agent:content-transfer-encoding:references
 :in-reply-to:date:to:from:subject:message-id:from:to:cc:subject:date
 :message-id:reply-to;
 bh=XssRLuOmcGP6vpszTfWg8PAMTRbmxkaS7YuP0airGMA=;
 b=FsJ9gcAXCv2dDjTA1xOzlxk5QLT+u/gt4gPHfS3UYXthGFAPQ4PeNZOsCXh2GuO3Zl
 /DeYlCNdBqyu66Og8QsXJc4Yl0T+Z6MYFBJLPhggn2GyzJQ/PWQNsAeRFJOoM5j2CtSJ
 blolK9uoQlX8yOk59EUCi85N+ycqY5SDuUQEe9OFbA50zgKn+fhQQl1H5YXtXAMPHzVe
 GDbNoE1KuyNVUOOaVVHexQb4XGenSvY6/qd2Bp3qi73fuLIBmPY7u8B+u1FEDfhgVcyM
 oXnTtL6RPPyWWAKeI1H6A2/EOw2RJ4ohYfEVJlo0q3Kz6b5rtgNN7epGQ4Yw/Jm5rO/R
 mzZg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=mime-version:user-agent:content-transfer-encoding:references
 :in-reply-to:date:to:from:subject:message-id:x-gm-message-state:from
 :to:cc:subject:date:message-id:reply-to;
 bh=XssRLuOmcGP6vpszTfWg8PAMTRbmxkaS7YuP0airGMA=;
 b=uUu0KT5NbYbVOb9X0DcrPdPSclQi/1eV7XAftyEp5k1zz6LJ1Bd7y5eImqcp5TWsc2
 tZF84cywuFwD7YOrJ9tUFzCc/NMgAWI2iYdAnlKvgy3cIb0B9NiLijciqSnHro6t3lwv
 ybSGLRPi4twurTOA7wmiz0eMH+euSjGwYpdrr3zg0c7WJSDDZLv2+oCcnSV6YOmHREuu
 VCr0DMdscSXz6NnievEy/gYig1KM78BX3LC5TrICoNGEarT2ba/eMHYjtkOFxHRPPMra
 AgEtDadOX5lrRAIVBO4EiQGQGCKdaogtg6L3P2NBUh2p5i2xwqzwwfVtNrIEeLw26k9z
 e/pw==
X-Gm-Message-State: AO0yUKX8eI3RgQSkL2j8aS9A4CI5aH+X/+2P7dAwJTMkMkeOxeHrw5Ha
 EePh8fep7oucIzzbb3clBMY=
X-Google-Smtp-Source: AK7set9isD2GWne7e0PpLiC6bOnF6c8GS5HH6k3VEYLTkt4ETzch1RdHFlW3Cmhp16mRvGCDDko7Wg==
X-Received: by 2002:a17:906:16c2:b0:888:33a:e359 with SMTP id
 t2-20020a17090616c200b00888033ae359mr11353917ejd.38.1675464880736; 
 Fri, 03 Feb 2023 14:54:40 -0800 (PST)
Received: from lumine.fritz.box (85-127-52-93.dsl.dynamic.surfer.at.
 [85.127.52.93]) by smtp.gmail.com with ESMTPSA id
 s7-20020a1709064d8700b0087221268e49sm1972900eju.186.2023.02.03.14.54.40
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Fri, 03 Feb 2023 14:54:40 -0800 (PST)
Message-ID: <8e79fe217c633650394f2c5199e94e5d0c5a7911.camel@HIDDEN>
Subject: Re: [PATCH] doc: Document 'shebang' for 'guix shell'.
From: Liliana Marie Prikler <liliana.prikler@HIDDEN>
To: Simon Tournier <zimon.toutoune@HIDDEN>, 61094 <at> debbugs.gnu.org
Date: Fri, 03 Feb 2023 23:54:38 +0100
In-Reply-To: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
References: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
User-Agent: Evolution 3.46.0 
MIME-Version: 1.0
X-Spam-Score: 1.3 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  Am Freitag, dem 27.01.2023 um 12:12 +0100 schrieb Simon Tournier:
    > * doc/guix.texi (Invoking guix shell): Add a note mentioning how to > use
    > 'shebang'. > --- >  doc/guix.texi | 15 ++++++++++++++- [...] 
 
 Content analysis details:   (1.3 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (liliana.prikler[at]gmail.com)
  1.3 RCVD_IN_VALIDITY_RPBL  RBL: Relay in Validity RPBL,
                             https://senderscore.org/blocklistlookup/
                             [209.85.218.67 listed in bl.score.senderscore.com]
  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 -0.0 SPF_PASS               SPF: sender matches SPF record
 -0.0 RCVD_IN_DNSWL_NONE     RBL: Sender listed at https://www.dnswl.org/,
                              no trust
                             [209.85.218.67 listed in list.dnswl.org]
  0.0 RCVD_IN_MSPIKE_H3      RBL: Good reputation (+3)
                             [209.85.218.67 listed in wl.mailspike.net]
  0.0 RCVD_IN_MSPIKE_WL      Mailspike good senders
X-Debbugs-Envelope-To: 61094
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.3 (/)

Am Freitag, dem 27.01.2023 um 12:12 +0100 schrieb Simon Tournier:
> * doc/guix.texi (Invoking guix shell): Add a note mentioning how to
> use
> 'shebang'.
> ---
> =C2=A0doc/guix.texi | 15 ++++++++++++++-
> =C2=A01 file changed, 14 insertions(+), 1 deletion(-)
>=20
> diff --git a/doc/guix.texi b/doc/guix.texi
> index 2b1ad77ba5..acda01c8e6 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -71,7 +71,7 @@ Copyright @copyright{} 2019 Kyle Andrews@*
> =C2=A0Copyright @copyright{} 2019 Alex Griffin@*
> =C2=A0Copyright @copyright{} 2019, 2020, 2021, 2022 Guillaume Le
> Vaillant@*
> =C2=A0Copyright @copyright{} 2020 Liliana Marie Prikler@*
> -Copyright @copyright{} 2019, 2020, 2021, 2022 Simon Tournier@*
> +Copyright @copyright{} 2019, 2020, 2021, 2022, 2023 Simon Tournier@*
> =C2=A0Copyright @copyright{} 2020 Wiktor =C5=BBelazny@*
> =C2=A0Copyright @copyright{} 2020 Damien Cassou@*
> =C2=A0Copyright @copyright{} 2020 Jakub K=C4=85dzio=C5=82ka@*
> @@ -5923,6 +5923,19 @@ building or downloading any missing package,
> and runs the
> =C2=A0guix shell python python-numpy -- python3
> =C2=A0@end example
> =C2=A0
> +@quotation Note
> +@cindex shebang
> +@command{guix shell} can be used as @emph{shebang}.=C2=A0 Consider the
> +previous example as an executable Python script, the @emph{shebang}
> +reads,
> +
> +@example
> +#!/usr/bin/env -S guix shell python python-nympy -- python3
> +@end example
> +
> +All the @var{options} or convenience of @command{guix shell} apply.
> +@end quotation
> +
Is this really guix running as a shell or is it actually a feature of
env?  In either case, it's worth documenting, but we should try to stay
factually correct.

Cheers
Information forwarded to guix-patches@HIDDEN:
bug#61094; Package guix-patches. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 27 Jan 2023 11:12:50 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jan 27 06:12:50 2023
Received: from localhost ([127.0.0.1]:36822 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1pLMf3-00035O-Ou
	for submit <at> debbugs.gnu.org; Fri, 27 Jan 2023 06:12:50 -0500
Received: from lists.gnu.org ([209.51.188.17]:46766)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <zimon.toutoune@HIDDEN>) id 1pLMf1-00035H-Vf
 for submit <at> debbugs.gnu.org; Fri, 27 Jan 2023 06:12:48 -0500
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <zimon.toutoune@HIDDEN>)
 id 1pLMf1-0001zQ-Lq
 for guix-patches@HIDDEN; Fri, 27 Jan 2023 06:12:47 -0500
Received: from mail-wm1-x32d.google.com ([2a00:1450:4864:20::32d])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <zimon.toutoune@HIDDEN>)
 id 1pLMf0-0002o1-5j
 for guix-patches@HIDDEN; Fri, 27 Jan 2023 06:12:47 -0500
Received: by mail-wm1-x32d.google.com with SMTP id m15so3184729wms.4
 for <guix-patches@HIDDEN>; Fri, 27 Jan 2023 03:12:45 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:subject:cc
 :to:from:from:to:cc:subject:date:message-id:reply-to;
 bh=MjaQdebNWDw7qEhM2v7GryadosWZRsBiftiuZfN1Wiw=;
 b=VdFlINLSwbo4SXPxezDIqaV4bL3CjJXTU81PxcWaLV1Eh5L7AgMtdD0btxIjoImVIU
 rjttUpNEF9EEjXChWjfPY3C+z7bNyOx5vAnJwxxBhyg79QzPWLfCTLjhVQhUngu/cV/V
 SrNk142Rbe+tQNvjINWwZ9MEktfLOjuN3s4Kpnp7X+5ObCIepwk39+NYutFykzP6efbM
 B0KJnyQMw1A8Rm0LQ7wpoaNXwbO/CGwIFgCqhccW0nQkb6vuzYlCYQxTjIyW+U8ceoyW
 IL0ckuq9S7z+ArQZJzeDhKLfNy2jh+iyzeECAhe+i/jgyIFRnd6l/SMzQGfiToqe0rbU
 jLsA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=content-transfer-encoding:mime-version:message-id:date:subject:cc
 :to:from:x-gm-message-state:from:to:cc:subject:date:message-id
 :reply-to;
 bh=MjaQdebNWDw7qEhM2v7GryadosWZRsBiftiuZfN1Wiw=;
 b=s6GuXvTVtDf7XDFjB73szCNV6pagWElO+BwfrJNWg42sXx99J/Lj1VQ3AdVjVvP4kb
 ZqLRyGzavMJdbTHSRcse/Sqc2ra/lasJXcO82SUnYvs4gICoy/mYOj/r9+05Nk//M7ZG
 D6KFafzqR4pzSXYvNTIvt1JAAkI4T2Zmow2uoosn2Oi/8BCZsZtUINgcw5HI96IOswZq
 OlHrZVPy1bCjd8l0nHOUXI5E9wulE5/LXsVBErOIvLlORuqx9BDmo1XmBhxGhMe9Ee0B
 C++dGSVBQ7o8PXPotoqJ48s99btw8iZi4Gou1Z+iCpfj/YdVpR2D4scRJW2UukTmk5As
 YpNw==
X-Gm-Message-State: AFqh2kpds01cs3hE9RToxJjszmKv85dzJGKxuwXO/5JkIWRHnPOLr87v
 siyFMGnZvYnivSduuqcTJQGhjhMZh0c=
X-Google-Smtp-Source: AMrXdXtF+Q4+izcRVQEfemuVHftirxxTITJX3tyLma8bCQ9i9H3iIGz1I26XNrYgw5Lm+6pwSepBZw==
X-Received: by 2002:a05:600c:3b05:b0:3d3:4f99:bb14 with SMTP id
 m5-20020a05600c3b0500b003d34f99bb14mr8637756wms.0.1674817964387; 
 Fri, 27 Jan 2023 03:12:44 -0800 (PST)
Received: from localhost.localdomain ([193.48.40.241])
 by smtp.gmail.com with ESMTPSA id
 c3-20020a1c3503000000b003dc1d668866sm7091661wma.10.2023.01.27.03.12.43
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Fri, 27 Jan 2023 03:12:44 -0800 (PST)
From: Simon Tournier <zimon.toutoune@HIDDEN>
To: guix-patches@HIDDEN
Subject: [PATCH] doc: Document 'shebang' for 'guix shell'.
Date: Fri, 27 Jan 2023 12:12:37 +0100
Message-Id: <20230127111237.2910126-1-zimon.toutoune@HIDDEN>
X-Mailer: git-send-email 2.38.1
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Received-SPF: pass client-ip=2a00:1450:4864:20::32d;
 envelope-from=zimon.toutoune@HIDDEN; helo=mail-wm1-x32d.google.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, 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_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-Debbugs-Envelope-To: submit
Cc: Simon Tournier <zimon.toutoune@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)

* doc/guix.texi (Invoking guix shell): Add a note mentioning how to use
'shebang'.
---
 doc/guix.texi | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 2b1ad77ba5..acda01c8e6 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -71,7 +71,7 @@ Copyright @copyright{} 2019 Kyle Andrews@*
 Copyright @copyright{} 2019 Alex Griffin@*
 Copyright @copyright{} 2019, 2020, 2021, 2022 Guillaume Le Vaillant@*
 Copyright @copyright{} 2020 Liliana Marie Prikler@*
-Copyright @copyright{} 2019, 2020, 2021, 2022 Simon Tournier@*
+Copyright @copyright{} 2019, 2020, 2021, 2022, 2023 Simon Tournier@*
 Copyright @copyright{} 2020 Wiktor Żelazny@*
 Copyright @copyright{} 2020 Damien Cassou@*
 Copyright @copyright{} 2020 Jakub Kądziołka@*
@@ -5923,6 +5923,19 @@ building or downloading any missing package, and runs the
 guix shell python python-numpy -- python3
 @end example
 
+@quotation Note
+@cindex shebang
+@command{guix shell} can be used as @emph{shebang}.  Consider the
+previous example as an executable Python script, the @emph{shebang}
+reads,
+
+@example
+#!/usr/bin/env -S guix shell python python-nympy -- python3
+@end example
+
+All the @var{options} or convenience of @command{guix shell} apply.
+@end quotation
+
 Development environments can be created as in the example below, which
 spawns an interactive shell containing all the dependencies and
 environment variables needed to work on Inkscape:

base-commit: 8e1cca32b938cef0812ce042c6c2e8bccb326ec7
-- 
2.38.1
Acknowledgement sent to Simon Tournier <zimon.toutoune@HIDDEN>:
New bug report received and forwarded. Copy sent to guix-patches@HIDDEN. Full text available.
Report forwarded to guix-patches@HIDDEN:
bug#61094; Package guix-patches. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Thu, 16 Mar 2023 11:30:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.