GNU bug report logs - #54190
29.0.50; [PATCH] Incorrect/missing documentation for some Eshell "$" syntaxes

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: emacs; Severity: minor; Reported by: Jim Porter <jporterbugs@HIDDEN>; Keywords: patch; dated Sun, 27 Feb 2022 21:35:02 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

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


Received: (at 54190) by debbugs.gnu.org; 28 Feb 2022 09:38:43 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 28 04:38:43 2022
Received: from localhost ([127.0.0.1]:60059 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1nOcUN-0005IP-82
	for submit <at> debbugs.gnu.org; Mon, 28 Feb 2022 04:38:43 -0500
Received: from quimby.gnus.org ([95.216.78.240]:34546)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1nOcUL-0005IB-JV
 for 54190 <at> debbugs.gnu.org; Mon, 28 Feb 2022 04:38:42 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date:
 References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=GBrfacDkpbCi3fOTtfMQEO9Gjbo0AwTG7/R9ZU8TaqE=; b=vEnBN4CrD0dCS5T0++cP23khXn
 Sw5IPSk+/skW7FtVM0XgxdNKorbktuami2rf+7gyvdLKYOF2QtG/Q5a7ZZ/iWa+0yagy/cYlkjBdS
 r/KkmkWP0FogPl68E7xNyNkr7Oh3mcz0aVCjRf+uSBd9w9FfmiK08mRKIxCv3vscj4DU=;
Received: from [84.212.220.105] (helo=giant)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1nOcUB-0005t7-Rs; Mon, 28 Feb 2022 10:38:34 +0100
From: Lars Ingebrigtsen <larsi@HIDDEN>
To: Jim Porter <jporterbugs@HIDDEN>
Subject: Re: bug#54190: 29.0.50; [PATCH] Incorrect/missing documentation for
 some Eshell "$" syntaxes
References: <0c3898ff-23ac-51bc-2211-770302d7d00e@HIDDEN>
 <06a184d5-b191-4c63-a851-13d1c8c18eda@HIDDEN>
 <1dfa575b-bf3f-84ca-b7b5-a612ffc57737@HIDDEN>
X-Now-Playing: Xiu Xiu's _The Passenger_: "Ian Curtis Wish List SOLO"
Date: Mon, 28 Feb 2022 10:38:31 +0100
In-Reply-To: <1dfa575b-bf3f-84ca-b7b5-a612ffc57737@HIDDEN> (Jim Porter's
 message of "Mon, 28 Feb 2022 00:16:21 -0800")
Message-ID: <87o82rqqjs.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.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
 @@CONTACT_ADDRESS@@ for details.
 Content preview:  Jim Porter <jporterbugs@HIDDEN> writes: > Ok, the breaking
 commit is b03f74e0f2a578b1580e8b1c368665850ee7f808 > ("Don't quote lambdas
 in several places"). Reverting the change in > that commit in
 lisp/eshell/esh-var.el fixes things, althoug [...] 
 Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 54190
Cc: 54190 <at> debbugs.gnu.org, Stefan Monnier <monnier@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 (---)

Jim Porter <jporterbugs@HIDDEN> writes:

> Ok, the breaking commit is b03f74e0f2a578b1580e8b1c368665850ee7f808
> ("Don't quote lambdas in several places"). Reverting the change in
> that commit in lisp/eshell/esh-var.el fixes things, although I'm not
> sure why yet. I believe that code gets evaluated by `eshell-do-eval',
> which evaluates things in a very particular way in order to support
> deferring evaluation at various points. Once I'm sure I understand why
> this is breaking, I'll post a patch to fix the bustage.

It's this bit?  Hm...

diff --git a/lisp/eshell/esh-var.el b/lisp/eshell/esh-var.el
index 96838d4132..7388279f15 100644
--- a/lisp/eshell/esh-var.el
+++ b/lisp/eshell/esh-var.el
@@ -463,8 +463,8 @@ eshell-parse-variable-ref
                    (eshell-as-subcommand ,(eshell-parse-command cmd))
                    (ignore
                     (nconc eshell-this-command-hook
-                           (list (function (lambda ()
-                                              (delete-file ,temp))))))
+                           (list (lambda ()
+                                   (delete-file ,temp)))))
                    (quote ,temp)))
             (goto-char (1+ end)))))))
    ((eq (char-after) ?\()


Trying to follow the logic of how this is eventually evaluated isn't,
er, obvious, but I'm not sure how that change could break anything,
either.  Perhaps Stefan has a comment; added to the CCs.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#54190; Package emacs. Full text available.

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


Received: (at 54190) by debbugs.gnu.org; 28 Feb 2022 08:16:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 28 03:16:40 2022
Received: from localhost ([127.0.0.1]:59949 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1nObCn-0000zb-Ct
	for submit <at> debbugs.gnu.org; Mon, 28 Feb 2022 03:16:39 -0500
Received: from mail-pj1-f52.google.com ([209.85.216.52]:44985)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <jporterbugs@HIDDEN>) id 1nObCl-0000zK-Hy
 for 54190 <at> debbugs.gnu.org; Mon, 28 Feb 2022 03:16:27 -0500
Received: by mail-pj1-f52.google.com with SMTP id
 cp23-20020a17090afb9700b001bbfe0fbe94so10658088pjb.3
 for <54190 <at> debbugs.gnu.org>; Mon, 28 Feb 2022 00:16:27 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=subject:from:to:references:message-id:date:mime-version:in-reply-to
 :content-language:content-transfer-encoding;
 bh=NAuZBtg+wfuYCSd/0cQplxwnyCckvWYJ9MtCQpBtxck=;
 b=mfLHAbI/ZhKHa08cPaUnZEiipxZW3xwplP+Hzaxk2wWn4pFIvzrCXsS9vM0DkbQNUP
 tXWSpIB0fQP8Ox1b8LWVAF4pAE4RMbzNH3wVjxb5Wr3ScBDiwKBiiwM8H2IoNeJZ+uHi
 DskY5/sclLlsdze7RLHP0VVsRksGqZhzmif6oWs6ltCxqOGMBRwe2SDg57iQE+oz8FRd
 IgHCVGIuVyY4UIgP8pPv91BMM5sBzchMzCQaPXUjrRsXqxs8mIi0JCfq5TUBKXCG8hND
 KSS9BJaP5fPWDf3wgTUVn+yl6gAHJa1hwcXHwTYcLcCjEMYaRnLRfV8wHN1t4jV6iLtz
 HpGQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:subject:from:to:references:message-id:date
 :mime-version:in-reply-to:content-language:content-transfer-encoding;
 bh=NAuZBtg+wfuYCSd/0cQplxwnyCckvWYJ9MtCQpBtxck=;
 b=OzCeT7sviGVEs+RQ3KPzfoTQ1Cq9DYir3OTs97//0RJISBYqEYQ0MEEmuonEIVmg7o
 QiXqk+KEiePoHqRXUpa9kj2AAMrBoEb0xli/OKh2nKWc94CNtSjI1yHNSk/BYlmFh+MI
 JHDBUqeEsIJzWlmoZUGC58rxAhHV6TMjHr7ZNSsgG4Fv189gGO/hXwEohf+RUVc74XmU
 SA75AgP3cj223KMQfI1jgWOqf6zhaHtTyUgNSuUNvs++6vC/yzXibeVtIj4ML7Mghc/Q
 5GxYkJ0unIynw2CgIZnAxS3sqOHW7wrAv+4dydtHZNmBZLpsLLqa7vhJ+J/oYSjib7y/
 qtRA==
X-Gm-Message-State: AOAM533ybO9Qn6CWGjwRU8cpempSIYWmM2okl4c3IbpkoNJzrimPlnfX
 wQqUU3BJSi99L6eSMSEJUtQO4Cz5OM8=
X-Google-Smtp-Source: ABdhPJxYtNL//e4XxDaKzMCdDyjB1N4efbV8t5quqguQUBplX/OAj10glT6BuEXTR7SRNJyaZN8TZQ==
X-Received: by 2002:a17:902:cece:b0:150:3f2:4616 with SMTP id
 d14-20020a170902cece00b0015003f24616mr19664769plg.41.1646036181649; 
 Mon, 28 Feb 2022 00:16:21 -0800 (PST)
Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com.
 [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id
 23-20020a17090a0d5700b001bc3c650e01sm20108659pju.1.2022.02.28.00.16.20
 for <54190 <at> debbugs.gnu.org>
 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
 Mon, 28 Feb 2022 00:16:21 -0800 (PST)
Subject: Re: bug#54190: 29.0.50; [PATCH] Incorrect/missing documentation for
 some Eshell "$" syntaxes
From: Jim Porter <jporterbugs@HIDDEN>
To: 54190 <at> debbugs.gnu.org
References: <0c3898ff-23ac-51bc-2211-770302d7d00e@HIDDEN>
 <06a184d5-b191-4c63-a851-13d1c8c18eda@HIDDEN>
Message-ID: <1dfa575b-bf3f-84ca-b7b5-a612ffc57737@HIDDEN>
Date: Mon, 28 Feb 2022 00:16:21 -0800
MIME-Version: 1.0
In-Reply-To: <06a184d5-b191-4c63-a851-13d1c8c18eda@HIDDEN>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 54190
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 (-)

On 2/27/2022 10:11 PM, Jim Porter wrote:
> Hmm, that's unfortunate. It seems that the "$<FOO>" syntax in Eshell 
> broke sometime between 27.2 and 28. I'm bisecting to figure out where 
> that happened, but figured I'd mention it now so there's no confusion if 
> someone tries it out now on 28/29. Fix forthcoming (hopefully).

Ok, the breaking commit is b03f74e0f2a578b1580e8b1c368665850ee7f808 
("Don't quote lambdas in several places"). Reverting the change in that 
commit in lisp/eshell/esh-var.el fixes things, although I'm not sure why 
yet. I believe that code gets evaluated by `eshell-do-eval', which 
evaluates things in a very particular way in order to support deferring 
evaluation at various points. Once I'm sure I understand why this is 
breaking, I'll post a patch to fix the bustage.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#54190; Package emacs. Full text available.

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


Received: (at 54190) by debbugs.gnu.org; 28 Feb 2022 06:11:10 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Feb 28 01:11:09 2022
Received: from localhost ([127.0.0.1]:59843 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1nOZFV-0006HX-PK
	for submit <at> debbugs.gnu.org; Mon, 28 Feb 2022 01:11:09 -0500
Received: from mail-pf1-f170.google.com ([209.85.210.170]:40920)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <jporterbugs@HIDDEN>) id 1nOZFT-0006HK-WC
 for 54190 <at> debbugs.gnu.org; Mon, 28 Feb 2022 01:11:08 -0500
Received: by mail-pf1-f170.google.com with SMTP id z15so10150081pfe.7
 for <54190 <at> debbugs.gnu.org>; Sun, 27 Feb 2022 22:11:07 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=subject:from:to:references:message-id:date:mime-version:in-reply-to
 :content-language:content-transfer-encoding;
 bh=8knzE8l6BfwMD8HXzFKvdvL87Ghdq2GELgFatLMJJ+0=;
 b=iNUD3IN2N+8PDk1WFaHIVPdyGvLX2RMAEeDXUFmxyILOezvJ0DQ6MzXKY9zTFa6QI4
 UGRBjMTmupYIEM8r4+QwyGc0SHy8W/d7js1h3mXK8rPJQ5QUDP6drKbfYqEc/y8mkpQ8
 2m6gUehegAFs+OQEIJOzMDuZmBqvrjk/B4XYSUqb9vwB1wkfJpUNyDRztwcpJs0RL+XL
 DTKeAiUyAvPZ2ldrEnQT3yXO5m3dAPZtF+d/ZJYtAPuqd/r2AZM+o7RmEANh6GPdHYUN
 J6pKCFNKcjeeDKa1If4Xs5wYr6+QcJa0QoIQPYL8sCLs/q2LBtZWzvJLC8tNTgTpij3+
 TThQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:subject:from:to:references:message-id:date
 :mime-version:in-reply-to:content-language:content-transfer-encoding;
 bh=8knzE8l6BfwMD8HXzFKvdvL87Ghdq2GELgFatLMJJ+0=;
 b=BLNGlJXQ4D4uVphyyZrDP0pGR42uh1EhPbTR2kQwWofhsWPYAFfMZq73JX9U4KnC6x
 9ckacUdSVkIdofMBSEuEIaqdSvYvYoaLHmxF5mfkpBmU7kvCrIwpYVmFX6gxbco23f5/
 eNVM0YOqzFw7EJsCiw+BEciub0FOgkYW83hsZnkxqn7Rw9zd2B3VuaHFGqOp8/TmLs2d
 ZbL0WtF7jsTQWD2EliFY83JHM3UgHTMFplpo1Gfbm8arABiBG1kGEatpi8J5kP5yPzRx
 KI8kTdlih4fjDYZ8WuQLwsm8PIP1bjY1uzFPRl2YzJN2RWsDuHQL2RT/HqDQbpqGNfwD
 XDvg==
X-Gm-Message-State: AOAM531ppiLFTwpaaEpXNrjJOVOaq3gf/y52c1HEUYEytI1VbQm0xOx0
 lkqCfzsKJU+Imf/Q29A2OsmORh0CDZE=
X-Google-Smtp-Source: ABdhPJwfBg9Kqivei2O2dCMpf3u0RCI3mJfvXXzUu+ZOfxL4CsmtxgyB4AhovjJLUTQ3Vvxp6DrPKA==
X-Received: by 2002:a05:6a00:234a:b0:4e0:f776:876b with SMTP id
 j10-20020a056a00234a00b004e0f776876bmr20166030pfj.84.1646028662190; 
 Sun, 27 Feb 2022 22:11:02 -0800 (PST)
Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com.
 [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id
 k5-20020aa788c5000000b004df7bf0a290sm11706557pff.1.2022.02.27.22.11.01
 for <54190 <at> debbugs.gnu.org>
 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
 Sun, 27 Feb 2022 22:11:01 -0800 (PST)
Subject: Re: bug#54190: 29.0.50; [PATCH] Incorrect/missing documentation for
 some Eshell "$" syntaxes
From: Jim Porter <jporterbugs@HIDDEN>
To: 54190 <at> debbugs.gnu.org
References: <0c3898ff-23ac-51bc-2211-770302d7d00e@HIDDEN>
Message-ID: <06a184d5-b191-4c63-a851-13d1c8c18eda@HIDDEN>
Date: Sun, 27 Feb 2022 22:11:01 -0800
MIME-Version: 1.0
In-Reply-To: <0c3898ff-23ac-51bc-2211-770302d7d00e@HIDDEN>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 54190
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 (-)

On 2/27/2022 1:34 PM, Jim Porter wrote:
> In fact, what "$<FOO>" does is to run FOO as a subcommand, writing its 
> stdout to a temp file, and returning that file's name.
Hmm, that's unfortunate. It seems that the "$<FOO>" syntax in Eshell 
broke sometime between 27.2 and 28. I'm bisecting to figure out where 
that happened, but figured I'd mention it now so there's no confusion if 
someone tries it out now on 28/29. Fix forthcoming (hopefully).
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#54190; Package emacs. Full text available.

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


Received: (at submit) by debbugs.gnu.org; 27 Feb 2022 21:34:35 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Feb 27 16:34:35 2022
Received: from localhost ([127.0.0.1]:59415 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1nORBb-0008OI-9c
	for submit <at> debbugs.gnu.org; Sun, 27 Feb 2022 16:34:35 -0500
Received: from lists.gnu.org ([209.51.188.17]:53446)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <jporterbugs@HIDDEN>) id 1nORBZ-0008OA-8h
 for submit <at> debbugs.gnu.org; Sun, 27 Feb 2022 16:34:33 -0500
Received: from eggs.gnu.org ([209.51.188.92]:41720)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <jporterbugs@HIDDEN>)
 id 1nORBZ-0003D5-31
 for bug-gnu-emacs@HIDDEN; Sun, 27 Feb 2022 16:34:33 -0500
Received: from [2607:f8b0:4864:20::434] (port=33712
 helo=mail-pf1-x434.google.com)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <jporterbugs@HIDDEN>)
 id 1nORBW-00062z-5P
 for bug-gnu-emacs@HIDDEN; Sun, 27 Feb 2022 16:34:31 -0500
Received: by mail-pf1-x434.google.com with SMTP id d17so9351215pfl.0
 for <bug-gnu-emacs@HIDDEN>; Sun, 27 Feb 2022 13:34:29 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=from:subject:to:message-id:date:mime-version:content-language;
 bh=nKjQbQq5mtozgCkmYKY5yU7iVfuSgNjoPGVz7aqk+lw=;
 b=PfA6Pvs8+0t53wnFQn7KyTCu0D+z0ZgvEKu0ovalbrDvtWZxHGGLetWUcd6YaqAQKD
 SzUXfkCBdwwZ4Sf9jpWBTnQVGGucc1/E3fAj3Widzzlq5JPP++SIb934Ee1Gb7EtNixY
 Yt8ct5RP289nrzYmY+OVO0aIqCu/mdLrWpxOdJUuqJ3R64dSvNigAKrg+3MlWy/5kOBX
 nzEaxRakpv3QjspxktVAdkwFZJLsMkFtnT+JcZgluM06F8axJBiT3H6NftlZkL0Fqs4X
 AOZLKwFx+LrgdYDorJhOiJHP/JbWfqEnCovcXHVe/VLSonp7ZgySYP19iBdidKm9PqpG
 ukag==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20210112;
 h=x-gm-message-state:from:subject:to:message-id:date:mime-version
 :content-language;
 bh=nKjQbQq5mtozgCkmYKY5yU7iVfuSgNjoPGVz7aqk+lw=;
 b=HfjZWSAUCDoEL/LVcBWtNv4svpnt0yqEfIK3GbO3HbzHWmeu8Cfs53OuBrtOs+EjRG
 AIQplxNRY3EayMK+jOG9PaVkJm2GSxGyJPhY4d0//kDHfCG12nFb0bS86GJmPcDB3m/Y
 mzceZYUxz9WBng4iiEl3WqO2CSc8V8/DAyimIhJZ6Yk7rCbeuWyos51jpDzGs0G+XE9a
 nXwWVgoZEkqy/UoXUInZPMf+A54cvN0yhuGbYqR4cAQhh4WxE0yO+Z3ffUe3+ULAY49z
 522VBiqxRMn8KA8YAk6xOgCDbz40Ou0O/D6C/tT1rp3GbI7S8y7oAjfjQKbaKM+A7YgE
 iStw==
X-Gm-Message-State: AOAM530DrwBkdkT3ptl8Nfcx25+nYw1W3XBXQ3L4HFJ8egHwbaB/Pkfh
 t+kkGAtM/Wx/sdXpmXAqQMDpSbOHHFI=
X-Google-Smtp-Source: ABdhPJyZ3E24avll2jucwFE1jctSHxe8HPuIizbHtA2aTAPBG3tDFuC/BserHTYjcdMUmawsC6a95A==
X-Received: by 2002:a63:2361:0:b0:378:af21:1d79 with SMTP id
 u33-20020a632361000000b00378af211d79mr1148760pgm.363.1645997668444; 
 Sun, 27 Feb 2022 13:34:28 -0800 (PST)
Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com.
 [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id
 d13-20020a17090ac24d00b001bcd7c2b2c3sm9485878pjx.16.2022.02.27.13.34.26
 for <bug-gnu-emacs@HIDDEN>
 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);
 Sun, 27 Feb 2022 13:34:26 -0800 (PST)
X-Mozilla-News-Host: news://news.gmane.org:119
From: Jim Porter <jporterbugs@HIDDEN>
Subject: 29.0.50; [PATCH] Incorrect/missing documentation for some Eshell "$"
 syntaxes
To: bug-gnu-emacs@HIDDEN
Message-ID: <0c3898ff-23ac-51bc-2211-770302d7d00e@HIDDEN>
Date: Sun, 27 Feb 2022 13:34:26 -0800
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="------------621208421B5428A95558A3F5"
Content-Language: en-US
X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::434
 (failed)
Received-SPF: pass client-ip=2607:f8b0:4864:20::434;
 envelope-from=jporterbugs@HIDDEN; helo=mail-pf1-x434.google.com
X-Spam_score_int: -6
X-Spam_score: -0.7
X-Spam_bar: /
X-Spam_report: (-0.7 / 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,
 PDS_HP_HELO_NORDNS=0.659, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793,
 SPF_HELO_NONE=0.001, SPF_PASS=-0.001,
 T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-Debbugs-Envelope-To: submit
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 (--)

This is a multi-part message in MIME format.
--------------621208421B5428A95558A3F5
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

In the documentation for lisp/eshell/esh-var.el (and 
`eshell-parse-variable-ref' in that file), it says that "$<FOO>" is a 
way of accessing the value of the variable FOO to disambiguate the 
length of the variable name, sort of like "${FOO}" in ordinary shells. 
However, that's not actually true. The correct syntax for that is:

   $"FOO"
   ;; or...
   $'FOO'

In fact, what "$<FOO>" does is to run FOO as a subcommand, writing its 
stdout to a temp file, and returning that file's name. This is (very!) 
subtly implied in the Eshell manual in the "Bugs and ideas" section, 
where it says:

   `grep python $<rpm -qa>' doesn't work, but using `*grep' does

   This happens because the `grep' Lisp function returns immediately,
   and then the asynchronous `grep' process expects to examine the
   temporary file, which has since been deleted.

Attached is a patch which updates the documentation to correctly 
describe the current behavior. Note: since this is just a documentation 
change, it might be worth pushing to the 28 branch.

--------------621208421B5428A95558A3F5
Content-Type: text/plain; charset=UTF-8;
 name="0001-Improve-correct-documentation-about-Eshell-variable-.patch"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename*0="0001-Improve-correct-documentation-about-Eshell-variable-.pa";
 filename*1="tch"

RnJvbSBlYzUyYjQ0ZjY5NGYyNTE1YmIzNjczZjk5OGU2ZWE4MGQyZDMxZTA4IE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j
b20+CkRhdGU6IFN1biwgMjcgRmViIDIwMjIgMTM6MjA6NTEgLTA4MDAKU3ViamVjdDogW1BB
VENIXSBJbXByb3ZlL2NvcnJlY3QgZG9jdW1lbnRhdGlvbiBhYm91dCBFc2hlbGwgdmFyaWFi
bGUgZXhwYW5zaW9uCgoqIGxpc3AvZXNoZWxsL2VzaC12YXIuZWw6IENvcnJlY3QgZG9jdW1l
bnRhdGlvbiBjb21tZW50LgooZXNoZWxsLXBhcnNlLXZhcmlhYmxlLXJlZik6IENvcnJlY3Qg
ZG9jc3RyaW5nLgoKKiBkb2MvbWlzYy9lc2hlbGwudGV4aSAoRG9sbGFycyBFeHBhbnNpb24p
OiBBZGQgZG9jdW1lbnRhdGlvbiBmb3IKJCJ2YXIiLyQndmFyJyBhbmQgJDxjb21tYW5kPiBz
eW50YXhlcy4KLS0tCiBkb2MvbWlzYy9lc2hlbGwudGV4aSAgIHwgMTEgKysrKysrKysrKysK
IGxpc3AvZXNoZWxsL2VzaC12YXIuZWwgfCAxNSArKysrKysrKysrKystLS0KIDIgZmlsZXMg
Y2hhbmdlZCwgMjMgaW5zZXJ0aW9ucygrKSwgMyBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQg
YS9kb2MvbWlzYy9lc2hlbGwudGV4aSBiL2RvYy9taXNjL2VzaGVsbC50ZXhpCmluZGV4IDI2
MWU4OGQwMGMuLjg4YTdkN2IxMzAgMTAwNjQ0Ci0tLSBhL2RvYy9taXNjL2VzaGVsbC50ZXhp
CisrKyBiL2RvYy9taXNjL2VzaGVsbC50ZXhpCkBAIC0xMDE2LDYgKzEwMTYsMTIgQEAgRG9s
bGFycyBFeHBhbnNpb24KIEV4cGFuZHMgdG8gdGhlIHZhbHVlIGJvdW5kIHRvIEBjb2Rle3Zh
cn0uICBUaGlzIGlzIHRoZSBtYWluIHdheSB0byB1c2UKIHZhcmlhYmxlcyBpbiBjb21tYW5k
IGludm9jYXRpb25zLgogCitAaXRlbSAkInZhciIKK0BpdGVtICQndmFyJworRXhwYW5kcyB0
byB0aGUgdmFsdWUgYm91bmQgdG8gQGNvZGV7dmFyfS4gIFRoaXMgaXMgdXNlZnVsIHRvCitk
aXNhbWJpZ3VhdGUgdGhlIHZhcmlhYmxlIG5hbWUgd2hlbiBjb25jYXRlbmF0aW5nIGl0IHdp
dGggYW5vdGhlcgordmFsdWUsIHN1Y2ggYXMgQHNhbXB7JCJ2YXIiLXN1ZmZpeH0uCisKIEBp
dGVtICQjdmFyCiBFeHBhbmRzIHRvIHRoZSBsZW5ndGggb2YgdGhlIHZhbHVlIGJvdW5kIHRv
IEBjb2Rle3Zhcn0uICBSYWlzZXMgYW4gZXJyb3IKIGlmIHRoZSB2YWx1ZSBpcyBub3QgYSBz
ZXF1ZW5jZQpAQCAtMTAzMCw2ICsxMDM2LDExIEBAIERvbGxhcnMgRXhwYW5zaW9uCiBSZXR1
cm5zIHRoZSBvdXRwdXQgb2YgQGNvbW1hbmR7Y29tbWFuZH0sIHdoaWNoIGNhbiBiZSBhbnkg
dmFsaWQgRXNoZWxsCiBjb21tYW5kIGludm9jYXRpb24sIGFuZCBtYXkgZXZlbiBjb250YWlu
IGV4cGFuc2lvbnMuCiAKK0BpdGVtICQ8Y29tbWFuZD4KK0FzIHdpdGggQHNhbXB7JEB7Y29t
bWFuZEB9fSwgZXZhbHVhdGVzIHRoZSBFc2hlbGwgY29tbWFuZCBpbnZvY2F0aW9uCitAY29t
bWFuZHtjb21tYW5kfSwgYnV0IHdyaXRlcyB0aGUgb3V0cHV0IHRvIGEgdGVtcG9yYXJ5IGZp
bGUgYW5kCityZXR1cm5zIHRoZSBmaWxlIG5hbWUuCisKIEBpdGVtICR2YXJbaV0KIEV4cGFu
ZHMgdG8gdGhlIEBjb2Rle2l9dGggZWxlbWVudCBvZiB0aGUgdmFsdWUgYm91bmQgdG8gQGNv
ZGV7dmFyfS4gIElmCiB0aGUgdmFsdWUgaXMgYSBzdHJpbmcsIGl0IHdpbGwgYmUgc3BsaXQg
YXQgd2hpdGVzcGFjZSB0byBtYWtlIGl0IGEgbGlzdC4KZGlmZiAtLWdpdCBhL2xpc3AvZXNo
ZWxsL2VzaC12YXIuZWwgYi9saXNwL2VzaGVsbC9lc2gtdmFyLmVsCmluZGV4IDVjOGRhY2Q5
ODAuLmNmZWZlMTVjOWMgMTAwNjQ0Ci0tLSBhL2xpc3AvZXNoZWxsL2VzaC12YXIuZWwKKysr
IGIvbGlzcC9lc2hlbGwvZXNoLXZhci5lbApAQCAtMzQsNyArMzQsOCBAQAogOzsKIDs7ICIt
IiBpcyBhIHZhbGlkIHBhcnQgb2YgYSB2YXJpYWJsZSBuYW1lLgogOzsKLTs7ICAgJDxNWVZB
Uj4tVE9PCis7OyAgICRcIk1ZVkFSXCItVE9PCis7OyAgICQnTVlWQVInLVRPTwogOzsKIDs7
IE9ubHkgIk1ZVkFSIiBpcyBwYXJ0IG9mIHRoZSB2YXJpYWJsZSBuYW1lIGluIHRoaXMgY2Fz
ZS4KIDs7CkBAIC01NSw2ICs1NiwxMSBAQAogOzsgUmV0dXJucyB0aGUgdmFsdWUgb2YgYW4g
ZXNoZWxsIHN1YmNvbW1hbmQuICBTZWUgdGhlIG5vdGUgYWJvdmUKIDs7IHJlZ2FyZGluZyBM
aXNwIGV2YWx1YXRpb25zLgogOzsKKzs7ICAgJDxjb21tYW5kPgorOzsKKzs7IEV2YWx1YXRl
cyBhbiBlc2hlbGwgc3ViY29tbWFuZCwgcmVkaXJlY3RpbmcgdGhlIG91dHB1dCB0byBhCis7
OyB0ZW1wb3JhcnkgZmlsZSwgYW5kIHJldHVybmluZyB0aGUgZmlsZSBuYW1lLgorOzsKIDs7
ICAgJEFOWVZBUlsxMF0KIDs7CiA7OyBSZXR1cm4gdGhlIDEwdGggZWxlbWVudCBvZiBBTllW
QVIuICBJZiBBTllWQVIncyB2YWx1ZSBpcyBhIHN0cmluZywKQEAgLTQyMyw5ICs0MjksMTIg
QEAgZXNoZWxsLXBhcnNlLXZhcmlhYmxlLXJlZgogUG9zc2libGUgb3B0aW9ucyBhcmU6CiAK
ICAgTkFNRSAgICAgICAgICBhbiBlbnZpcm9ubWVudCBvciBMaXNwIHZhcmlhYmxlIHZhbHVl
Ci0gIDxMT05HLU5BTUU+ICAgZGlzYW1iaWd1YXRlcyB0aGUgbGVuZ3RoIG9mIHRoZSBuYW1l
CisgIFwiTE9ORy1OQU1FXCIgICBkaXNhbWJpZ3VhdGVzIHRoZSBsZW5ndGggb2YgdGhlIG5h
bWUKKyAgJ0xPTkctTkFNRScgICBhcyBhYm92ZQogICB7Q09NTUFORH0gICAgIHJlc3VsdCBv
ZiBjb21tYW5kIGlzIHZhcmlhYmxlJ3MgdmFsdWUKLSAgKExJU1AtRk9STSkgICByZXN1bHQg
b2YgTGlzcCBmb3JtIGlzIHZhcmlhYmxlJ3MgdmFsdWUiCisgIChMSVNQLUZPUk0pICAgcmVz
dWx0IG9mIExpc3AgZm9ybSBpcyB2YXJpYWJsZSdzIHZhbHVlCisgIDxDT01NQU5EPiAgICAg
d3JpdGUgdGhlIG91dHB1dCBvZiBjb21tYW5kIHRvIGEgdGVtcG9yYXJ5IGZpbGU7CisgICAg
ICAgICAgICAgICAgcmVzdWx0IGlzIHRoZSBmaWxlIG5hbWUiCiAgIChjb25kCiAgICAoKGVx
IChjaGFyLWFmdGVyKSA/eykKICAgICAobGV0ICgoZW5kIChlc2hlbGwtZmluZC1kZWxpbWl0
ZXIgP1x7ID9cfSkpKQotLSAKMi4yNS4xCgo=
--------------621208421B5428A95558A3F5--
Acknowledgement sent to Jim Porter <jporterbugs@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#54190; Package emacs. 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: Mon, 28 Feb 2022 09:45:01 UTC

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