From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#54227: 29.0.50; [PATCH] Inconsistencies with Eshell variable interpolation Date: Thu, 03 Mar 2022 18:57:07 +0200 Message-ID: <8335jzj7oc.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24568"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 54227@debbugs.gnu.org To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Mar 03 17:58:12 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nPomJ-0006DL-El for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 03 Mar 2022 17:58:11 +0100 Original-Received: from localhost ([::1]:52030 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nPomI-00064O-Ci for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 03 Mar 2022 11:58:10 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:46756) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPomA-00060Y-RP for bug-gnu-emacs@gnu.org; Thu, 03 Mar 2022 11:58:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:49676) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nPomA-0002wv-Fv for bug-gnu-emacs@gnu.org; Thu, 03 Mar 2022 11:58:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nPomA-0001kq-Ce for bug-gnu-emacs@gnu.org; Thu, 03 Mar 2022 11:58:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 03 Mar 2022 16:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54227 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 54227-submit@debbugs.gnu.org id=B54227.16463266366690 (code B ref 54227); Thu, 03 Mar 2022 16:58:02 +0000 Original-Received: (at 54227) by debbugs.gnu.org; 3 Mar 2022 16:57:16 +0000 Original-Received: from localhost ([127.0.0.1]:43573 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPolQ-0001jq-6a for submit@debbugs.gnu.org; Thu, 03 Mar 2022 11:57:16 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40826) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPolO-0001ja-OA for 54227@debbugs.gnu.org; Thu, 03 Mar 2022 11:57:15 -0500 Original-Received: from [2001:470:142:3::e] (port=53634 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPolJ-0002rP-Er; Thu, 03 Mar 2022 11:57:09 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=P60tm3WHDsWi5NPg+fa+HiNbAEWOorliASTab7UN7Kg=; b=jU2hgfO1ZcZ6 l79fEY7QbYgYOK6x3G6u7fruPvRsifYdNOq+hGv+lnesAh1jyR7YNdntm906ICcg4kEDitJT44KOR cCofsF5UR+0xrwnhUgmSWF5C/dmKjgcWN+PAqkyaSAkIhzp5LQLUcgMzPFeWdETuS37zx5Tvly4iV TE7m6Ed3owZnHsM2KRzb+nPGEFh7oaw1mI6LPEOX8XB5B144hbh9OI906gWM6PQ76G8XTXLpxCKFy cKT4py7uk+P1FCHYE0iEXDgS7K4kBpFdpDtYD2JZPjoH+dhyQL3LnwmDSixxx2yQJL1OFnDpdT9FF hmZ6jxbMUs9yxelFtQSdJw==; Original-Received: from [87.69.77.57] (port=4853 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPolI-0005Lh-Rx; Thu, 03 Mar 2022 11:57:09 -0500 In-Reply-To: (message from Jim Porter on Wed, 2 Mar 2022 22:35:22 -0800) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:227962 Archived-At: > From: Jim Porter > Date: Wed, 2 Mar 2022 22:35:22 -0800 > > +@item $@var{expr}[@var{i...}] > +Expands to the @var{i}th element of the result of @var{expr}, an > +expression in one of the above forms listed here. If multiple indices > +are supplied, this will return a list containing the elements for each > +index. If @var{expr}'s value is a string, it will first be split at > +whitespace to make it a list. If @var{expr}'s value is an alist > +(@pxref{Association List Type, Association Lists, , elisp, The Emacs > +Lisp Reference Manual}), this will call @code{assoc} on the result of > +@var{expr}, returning the @code{cdr} of the element of the result > +whose car is equal to @code{"i"}. Thanks. I think the documentation parts of this should be reworded to be consistent with the manual's audience. The Eshell manual is for users, not necessarily for Lisp programmers. So explaining features in terms of Emacs primitives, such as assoc and car/cdr/caar is not the best way of documenting them. Can we reword this text such that the way the feature works is clear to non-programmers as well?