From unknown Fri Jun 13 11:34:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Resent-From: Jim Porter Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2023 02:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60846 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 60846@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.167383749426932 (code B ref -1); Mon, 16 Jan 2023 02:52:01 +0000 Received: (at submit) by debbugs.gnu.org; 16 Jan 2023 02:51:34 +0000 Received: from localhost ([127.0.0.1]:60034 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHFav-00070K-S3 for submit@debbugs.gnu.org; Sun, 15 Jan 2023 21:51:34 -0500 Received: from lists.gnu.org ([209.51.188.17]:60852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHFat-00070C-H4 for submit@debbugs.gnu.org; Sun, 15 Jan 2023 21:51:32 -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 ) id 1pHFat-0000nx-8j for bug-gnu-emacs@gnu.org; Sun, 15 Jan 2023 21:51:31 -0500 Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pHFar-0000xY-E4 for bug-gnu-emacs@gnu.org; Sun, 15 Jan 2023 21:51:31 -0500 Received: by mail-pj1-x1030.google.com with SMTP id bj3so24550170pjb.0 for ; Sun, 15 Jan 2023 18:51:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:subject:from:content-language:mime-version:date:message-id:from :to:cc:subject:date:message-id:reply-to; bh=g+oYdQrynDiETP7i8tACrgW3ABDp81beALRhtcdK1C8=; b=X8y9XRyK8HvF55tbDmIRlNdwU/tdXGtALlC1HQ9DM8cGxD452LmFMEHyYC7Ll+g8Zx cYR3X6mYoK7bkelkIqhkaSbyqfWN90LmKDyvbSimynb9E4QoKhi8ytmoMOPw6trfxB0W z3dhhFdgbvWVIwZ/KYAW8VcLSCHrIem4K2uadb2EFF9y0524AbaSB1yiqQrTxqFqeXIS /sG8VskZBgQ2exFfSkLGuD3v1ujscUbi+0xVD/PG0/+BdSaz8dCWUzo3s0ssoIphMaxE 1Y641IPEQ0x1S4b0cns/lZZMDjPPVC8iUjNEYpGL+1iNCSUM2LKGSh+5N8egJt0TtPV4 2gjQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:from:content-language:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=g+oYdQrynDiETP7i8tACrgW3ABDp81beALRhtcdK1C8=; b=4wlb8BwQRDpsBdRBoEEi+0carm6E7MVwvMh7ZrFG+Paw6BoxevvO4mXIOqGMYKK2ht IP3SEUin1+DJvg9ph/b9Uvr9L98mbBtTqvXP41AWX8fUYs5+ZfoVXRMl1hozCrGTQamH bCtCAn1XMywnNHYDyLZOiPDqpsx4/KF3RKIYy3Jj5gkPDB7DOJbrXWhXJnd/BABWGUqs TIiD1YK9H7oFYbA7UkLdiFwt06tmmR3WXDABw09iX9cym4bISApv9sP0s4tW42aSlY5G LvYq/MtStz+RpG8yygcAZyH9xyPSyvNYgL8TBQLtgqlkt5kULwhJNvWIQ0ZGc7guEkwH tw3Q== X-Gm-Message-State: AFqh2kpYBD0gTVZ1ZUCDAT/CCcRLE8InHExnhHaJHfrIdR0aCkGOTmVL Uz/nfE/Pi3dpdU8wlw4Gw+rvSrxHmAs8rw== X-Google-Smtp-Source: AMrXdXvg6UnNdWyu7V+IVNuwReyGF6XmxPOunQOiFirygHkftCNTa65rHzrlEa2vYKAKKophrfAoiA== X-Received: by 2002:a17:902:a712:b0:194:8a27:f5c6 with SMTP id w18-20020a170902a71200b001948a27f5c6mr5044412plq.22.1673837486819; Sun, 15 Jan 2023 18:51:26 -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 k7-20020a170902760700b00192bf7eaf28sm17954617pll.286.2023.01.15.18.51.24 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 15 Jan 2023 18:51:25 -0800 (PST) Content-Type: multipart/mixed; boundary="------------0aGEjTwvZlNZOElQZc5v07J2" Message-ID: Date: Sun, 15 Jan 2023 18:51:25 -0800 MIME-Version: 1.0 X-Mozilla-News-Host: news://news.gmane.io:119 Content-Language: en-US From: Jim Porter Received-SPF: pass client-ip=2607:f8b0:4864:20::1030; envelope-from=jporterbugs@gmail.com; helo=mail-pj1-x1030.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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --------------0aGEjTwvZlNZOElQZc5v07J2 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit The Eshell manual isn't as thorough as it could be about how users should invoke commands. While there's a reasonable amount of documentation about the details, it never directly describes how to run a simple command. Attached is a patch to remedy this. I also corrected the documentation about how Eshell picks what command to run in command form; previously, it stated that ordinary Lisp functions had higher priority than external commands, which isn't actually the case (unless you set 'eshell-prefer-lisp-functions'). Since this is purely a documentation change, I'd like to merge this to the Emacs 29 branch. --------------0aGEjTwvZlNZOElQZc5v07J2 Content-Type: text/plain; charset=UTF-8; name="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.patch" Content-Disposition: attachment; filename*0="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.pat"; filename*1="ch" Content-Transfer-Encoding: base64 RnJvbSBkMGU0Yjk0NjIzYjU4NDBhMjEyYzk3Yzc1YjE2NDFkYmJiZmY3N2VhIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgMTUgSmFuIDIwMjMgMTg6MzU6MzEgLTA4MDAKU3ViamVjdDogW1BB VENIXSBBZGQgbW9yZSBkZXRhaWwgYWJvdXQgaG93IHRvIGludm9rZSBFc2hlbGwgY29tbWFu ZHMKCiogZG9jL21pc2MvZXNoZWxsLnRleGkgKENvbW1hbmRzKTogTW92ZSBleHBsYW5hdGlv biBhYm91dCBrZXJuZWwKZnVuY3Rpb25zIHRvIGhlcmUuCihJbnZvY2F0aW9uKTogRGVzY3Jp YmUgY29tbWFuZCBmb3JtIGFuZCBMaXNwIGZvcm0uICBGaXggZG9jdW1lbnRhdGlvbgphYm91 dCBwcmlvcml0eSBvZiBjb21tYW5kcyBpbiBjb21tYW5kIGZvcm0uCi0tLQogZG9jL21pc2Mv ZXNoZWxsLnRleGkgfCA5MyArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0t LS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDcwIGluc2VydGlvbnMoKyksIDIzIGRlbGV0aW9u cygtKQoKZGlmZiAtLWdpdCBhL2RvYy9taXNjL2VzaGVsbC50ZXhpIGIvZG9jL21pc2MvZXNo ZWxsLnRleGkKaW5kZXggZmM3ZDUyZWI3MTEuLmI1NDQ0NzQxYjY2IDEwMDY0NAotLS0gYS9k b2MvbWlzYy9lc2hlbGwudGV4aQorKysgYi9kb2MvbWlzYy9lc2hlbGwudGV4aQpAQCAtMTkz LDYgKzE5MywxMiBAQCBDb21tYW5kcwogY2hhcHRlciBjb3ZlcnMgY29tbWFuZCBpbnZvY2F0 aW9ucyBpbiBFc2hlbGwsIGluY2x1ZGluZyB0aGUgY29tbWFuZAogaGlzdG9yeSBhbmQgaW52 b2tpbmcgY29tbWFuZHMgaW4gYSBzY3JpcHQgZmlsZS4KIAorVW5saWtlIHJlZ3VsYXIgc3lz dGVtIHNoZWxscywgRXNoZWxsIG5ldmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucworZGly ZWN0bHksIHN1Y2ggYXMgQGNvZGV7ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBM aXNwIGZ1bmN0aW9ucworYXZhaWxhYmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJ dCBkb2VzIHRoaXMgYnkgdHJhbnNmb3JtaW5nIHRoZQoraW5wdXQgbGluZSBpbnRvIGEgY2Fs bGFibGUgTGlzcCBmb3JtLkBmb290bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybQordGhhdCB3 aWxsIGJlIGludm9rZWQsIHR5cGU6IEBzYW1we2VzaGVsbC1wYXJzZS1jb21tYW5kICdlY2hv IGhlbGxvJ319CisKIEBtZW51CiAqIEludm9jYXRpb246OgogKiBBcmd1bWVudHM6OgpAQCAt MjA3LDIzICsyMTMsMTYgQEAgQ29tbWFuZHMKIAogQG5vZGUgSW52b2NhdGlvbgogQHNlY3Rp b24gSW52b2NhdGlvbgotVW5saWtlIHJlZ3VsYXIgc3lzdGVtIHNoZWxscywgRXNoZWxsIG5l dmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucwotZGlyZWN0bHksIHN1Y2ggYXMgQGNvZGV7 ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBMaXNwIGZ1bmN0aW9ucwotYXZhaWxh YmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJdCBkb2VzIHRoaXMgYnkgdHJhbnNm b3JtaW5nIHRoZQotaW5wdXQgbGluZSBpbnRvIGEgY2FsbGFibGUgTGlzcCBmb3JtLkBmb290 bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybSB0aGF0IHdpbGwgYmUgaW52b2tlZCwgdHlwZTog QHNhbXB7ZXNoZWxsLXBhcnNlLWNvbW1hbmQgImVjaG8gaGVsbG8ifX0KK0VzaGVsbCBpcyBi b3RoIGEgY29tbWFuZCBzaGVsbCBhbmQgYW4gRW1hY3MgTGlzcCBAYWNyb255bXtSRVBMfS4g IEFzIGEKK3Jlc3VsdCwgeW91IGNhbiBpbnZva2UgY29tbWFuZHMgaW4gdHdvIGRpZmZlcmVu dCB3YXlzOiBpbiBAZGZue2NvbW1hbmQKK2Zvcm19IG9yIGluIEBkZm57bGlzcCBmb3JtfS4K IAotVGhlIGNvbW1hbmQgY2FuIGJlIGVpdGhlciBhbiBFbGlzcCBmdW5jdGlvbiBvciBhbiBl eHRlcm5hbCBjb21tYW5kLgotRXNoZWxsIGxvb2tzIGZpcnN0IGZvciBhbiBhbGlhcyAoQHB4 cmVme0FsaWFzZXN9KSB3aXRoIHRoZSBzYW1lIG5hbWUgYXMgdGhlCi1jb21tYW5kLCB0aGVu IGEgYnVpbHQtaW4gKEBweHJlZntCdWlsdC1pbnN9KSBvciBhIGZ1bmN0aW9uIHdpdGggdGhl Ci1zYW1lIG5hbWU7IGlmIHRoZXJlIGlzIG5vIG1hdGNoLCBpdCB0aGVuIHRyaWVzIHRvIGV4 ZWN1dGUgaXQgYXMgYW4KLWV4dGVybmFsIGNvbW1hbmQuCi0KLVRoZSBzZW1pY29sb24gKEBj b2Rlezt9KSBjYW4gYmUgdXNlZCB0byBzZXBhcmF0ZSBtdWx0aXBsZSBjb21tYW5kCi1pbnZv Y2F0aW9ucyBvbiBhIHNpbmdsZSBsaW5lLiAgWW91IGNhbiBhbHNvIHNlcGFyYXRlIGNvbW1h bmRzIHdpdGgKLUBjb2RleyYmfSBvciBAY29kZXt8fH0uIFdoZW4gdXNpbmcgQGNvZGV7JiZ9 LCBFc2hlbGwgd2lsbCBleGVjdXRlIHRoZQotc2Vjb25kIGNvbW1hbmQgb25seSBpZiB0aGUg Zmlyc3Qgc3VjY2VlZHMgKGkuZS5AOiBoYXMgYW4gZXhpdAotc3RhdHVzIG9mIDApOyB3aXRo IEBjb2Rle3x8fSwgRXNoZWxsIHdpbGwgZXhlY3V0ZSB0aGUgc2Vjb25kIGNvbW1hbmQKLW9u bHkgaWYgdGhlIGZpcnN0IGZhaWxzLgorWW91IGNhbiB1c2UgdGhlIHNlbWljb2xvbiAoQGNv ZGV7O30pIHRvIHNlcGFyYXRlIG11bHRpcGxlIGNvbW1hbmQKK2ludm9jYXRpb25zIG9uIGEg c2luZ2xlIGxpbmUsIGV4ZWN1dGluZyBlYWNoIGluIHR1cm4uICBZb3UgY2FuIGFsc28KK3Nl cGFyYXRlIGNvbW1hbmRzIHdpdGggQGNvZGV7JiZ9IG9yIEBjb2Rle3x8fS4gV2hlbiB1c2lu ZyBAY29kZXsmJn0sCitFc2hlbGwgd2lsbCBleGVjdXRlIHRoZSBzZWNvbmQgY29tbWFuZCBv bmx5IGlmIHRoZSBmaXJzdCBzdWNjZWVkcworKGkuZS5AOiBoYXMgYW4gZXhpdCBzdGF0dXMg b2YgMCk7IHdpdGggQGNvZGV7fHx9LCBFc2hlbGwgd2lsbCBleGVjdXRlCit0aGUgc2Vjb25k IGNvbW1hbmQgb25seSBpZiB0aGUgZmlyc3QgZmFpbHMuCiAKIEEgY29tbWFuZCBpbnZvY2F0 aW9uIGZvbGxvd2VkIGJ5IGFuIGFtcGVyc2FuZCAoQGNvZGV7Jn0pIHdpbGwgYmUgcnVuCiBp biB0aGUgYmFja2dyb3VuZC4gIEVzaGVsbCBoYXMgbm8gam9iIGNvbnRyb2wsIHNvIHlvdSBj YW4gbm90IHN1c3BlbmQKQEAgLTIzMiwxMiArMjMxLDY0IEBAIEludm9jYXRpb24KIGNhbiBi ZSBjb250cm9sbGVkIHRoZSBzYW1lIHdheSBhcyBhbnkgb3RoZXIgYmFja2dyb3VuZCBwcm9j ZXNzIGluCiBFbWFjcy4KIAorQHN1YnNlY3Rpb24gQ29tbWFuZCBmb3JtCitDb21tYW5kIGZv cm0gbG9va3MgbXVjaCB0aGUgc2FtZSBhcyBpbiBvdGhlciBzaGVsbHMuICBBIGNvbW1hbmQK K2NvbnNpc3RzIG9mIGFyZ3VtZW50cyBzZXBhcmF0ZWQgYnkgc3BhY2VzOyB0aGUgZmlyc3Qg YXJndW1lbnQgaXMgdGhlCitjb21tYW5kIHRvIHJ1biwgd2l0aCBhbnkgc3Vic2VxdWVudCBh cmd1bWVudHMgYmVpbmcgcGFzc2VkIHRvIHRoYXQKK2NvbW1hbmQuCisKK0BleGFtcGxlCit+ ICQgZWNobyBoZWxsbworaGVsbG8KK0BlbmQgZXhhbXBsZQorCitUaGUgY29tbWFuZCBjYW4g YmUgZWl0aGVyIGFuIEVsaXNwIGZ1bmN0aW9uIG9yIGFuIGV4dGVybmFsIGNvbW1hbmQuCitF c2hlbGwgbG9va3MgZm9yIHRoZSBjb21tYW5kIGluIHRoZSBmb2xsb3dpbmcgb3JkZXI6CisK K0BlbnVtZXJhdGUKK0BpdGVtCitBcyBhIGNvbW1hbmQgYWxpYXMgKEBweHJlZntBbGlhc2Vz fSkKKworQGl0ZW0KK0FzIGEgYnVpbHQtaW4gY29tbWFuZCAoQHB4cmVme0J1aWx0LWluc30p CisKK0BpdGVtCitBcyBhbiBleHRlcm5hbCBwcm9ncmFtCisKK0BpdGVtCitBcyBhbiBvcmRp bmFyeSBMaXNwIGZ1bmN0aW9uCitAZW5kIGVudW1lcmF0ZQorCitAdmluZGV4IGVzaGVsbC1w cmVmZXItbGlzcC1mdW5jdGlvbnMKK0lmIHlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIG9yZGlu YXJ5IExpc3AgZnVuY3Rpb25zIG92ZXIgZXh0ZXJuYWwKK3Byb2dyYW1zLCBzZXQgdGhlIG9w dGlvbiBAY29kZXtlc2hlbGwtcHJlZmVyLWxpc3AtZnVuY3Rpb25zfSB0bworQGNvZGV7dH0u CisKK0BzdWJzZWN0aW9uIExpc3AgZm9ybQorTGlzcCBmb3JtIGxvb2tzIGxpa2Ugb3JkaW5h cnkgRW1hY3MgTGlzcCBjb2RlLCBiZWNhdXNlIHRoYXQncyB3aGF0IGl0Citpcy4gIEFzIGEg cmVzdWx0LCB5b3UgY2FuIHVzZSBhbnkgc3ludGF4IG5vcm1hbGx5IGF2YWlsYWJsZSB0byBh bgorRW1hY3MgTGlzcCBwcm9ncmFtIChAcHhyZWZ7VG9wLCAsICwgZWxpc3AsIFRoZSBFbWFj cyBMaXNwIFJlZmVyZW5jZQorTWFudWFsfSkuCisKK0BleGFtcGxlCit+ICQgKGZvcm1hdCAi aGVsbG8sICVzIiB1c2VyLWxvZ2luLW5hbWUpCitoZWxsbywgdXNlcgorQGVuZCBleGFtcGxl CisKK0luIGFkZGl0aW9uLCB5b3UgY2FuIEBlbXBoe2NvbWJpbmV9IGNvbW1hbmQgZm9ybXMg YW5kIExpc3AgZm9ybXMKK3RvZ2V0aGVyIGludG8gc2luZ2xlIHN0YXRlbWVudHMsIGxldHRp bmcgeW91IHVzZSB3aGF0ZXZlciBmb3JtIGlzIHRoZQorbW9zdCBjb252ZW5pZW50IGZvciBl eHByZXNzaW5nIHlvdXIgaW50ZW50aW9ucy4KKworQGV4YW1wbGUKK34gJCBscyAqLnBhdGNo ID4gKGZvcm1hdC10aW1lLXN0cmluZyAiJUYubG9nIikKK0BlbmQgZXhhbXBsZQorCiBAbm9k ZSBBcmd1bWVudHMKIEBzZWN0aW9uIEFyZ3VtZW50cwotT3JkaW5hcmlseSwgY29tbWFuZCBh cmd1bWVudHMgYXJlIHBhcnNlZCBieSBFc2hlbGwgYXMgZWl0aGVyIHN0cmluZ3MKK09yZGlu YXJpbHksIEVzaGVsbCBwYXJzZXMgYXJndW1lbnRzIGluIGNvbW1hbmQgZm9ybSBhcyBlaXRo ZXIgc3RyaW5ncwogb3IgbnVtYmVycywgZGVwZW5kaW5nIG9uIHdoYXQgdGhlIHBhcnNlciB0 aGlua3MgdGhleSBsb29rIGxpa2UuICBUbwotc3BlY2lmeSBhbiBhcmd1bWVudCBvZiBzb21l IG90aGVyIGRhdGEgdHlwZSwgeW91IGNhbiB1c2UgYW4KLUByZWZ7RG9sbGFycyBFeHBhbnNp b24sIEVsaXNwIGV4cHJlc3Npb259Ogorc3BlY2lmeSBhbiBhcmd1bWVudCBvZiBzb21lIG90 aGVyIGRhdGEgdHlwZSwgeW91IGNhbiB1c2UgYQorQHJlZntJbnZvY2F0aW9uLCBMaXNwIGZv cm19OgogCiBAZXhhbXBsZQogfiAkIGVjaG8gKGxpc3QgMSAyIDMpCkBAIC0zNTQsMTAgKzQw NSw2IEBAIEJ1aWx0LWlucwogc3VkbyBpcyBhbiBhbGlhcywgZGVmaW5lZCBhcyAiKnN1ZG8g JEBAKiIKIEBlbmQgZXhhbXBsZQogCi1AdmluZGV4IGVzaGVsbC1wcmVmZXItbGlzcC1mdW5j dGlvbnMKLUlmIHlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIHRoZSBidWlsdC1pbiBjb21tYW5k cyBpbnN0ZWFkIG9mIHRoZSBleHRlcm5hbAotY29tbWFuZHMsIHNldCBAY29kZXtlc2hlbGwt cHJlZmVyLWxpc3AtZnVuY3Rpb25zfSB0byBAY29kZXt0fS4KLQogU29tZSBvZiB0aGUgYnVp bHQtaW4gY29tbWFuZHMgaGF2ZSBkaWZmZXJlbnQgYmVoYXZpb3IgZnJvbSB0aGVpcgogZXh0 ZXJuYWwgY291bnRlcnBhcnRzLCBhbmQgc29tZSBoYXZlIG5vIGV4dGVybmFsIGNvdW50ZXJw YXJ0LiAgTW9zdCBvZgogdGhlc2Ugd2lsbCBwcmludCBhIHVzYWdlIG1lc3NhZ2Ugd2hlbiBn aXZlbiB0aGUgQGNvZGV7LS1oZWxwfSBvcHRpb24uCi0tIAoyLjI1LjEKCg== --------------0aGEjTwvZlNZOElQZc5v07J2-- From unknown Fri Jun 13 11:34:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Resent-From: Jim Porter Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2023 04:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60846 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 60846@debbugs.gnu.org Received: via spool by 60846-submit@debbugs.gnu.org id=B60846.167384167110453 (code B ref 60846); Mon, 16 Jan 2023 04:02:02 +0000 Received: (at 60846) by debbugs.gnu.org; 16 Jan 2023 04:01:11 +0000 Received: from localhost ([127.0.0.1]:60106 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHGgI-0002iW-Ay for submit@debbugs.gnu.org; Sun, 15 Jan 2023 23:01:10 -0500 Received: from mail-pj1-f44.google.com ([209.85.216.44]:40742) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHGgG-0002iG-GH for 60846@debbugs.gnu.org; Sun, 15 Jan 2023 23:01:09 -0500 Received: by mail-pj1-f44.google.com with SMTP id q23-20020a17090a065700b002290913a521so10391383pje.5 for <60846@debbugs.gnu.org>; Sun, 15 Jan 2023 20:01:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:references:to:from:content-language:subject :mime-version:date:message-id:from:to:cc:subject:date:message-id :reply-to; bh=AgDTc3/mnbcsBjryVLUJp1vhtN4x4zYpzxzw9Zi/IAk=; b=GQksnLVUUOeGQxwWQcwrvY+Uojll/Dga2Clt33m+65MNScalPSo0uRmdP523jzhOvG e9q/D199hhNAxU5e+EGVyMyXyaC4RKKQk0YkvOitNHtuHLawxg4C6GQT/JKnKyTy8OeO PvRn92W+82UykddJW2rM7R9V36xhktjcOtlS5MEavkheEdmOSYnFBAwMg5OGFmDwnARU OdkFsO8q/7f3OiVSy5EnKzGAZvZsVGb9alxzACuXjP4W8J+uSl/+Bw/LfYUTumAe99w9 2tEmZutDxC5091Pq0FuBU5sNouz0z5cCa6NJa/Hdtr+SklMLSUMK/1Xi+yQ9d4wcQLGa Z32A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:references:to:from:content-language:subject :mime-version:date:message-id:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=AgDTc3/mnbcsBjryVLUJp1vhtN4x4zYpzxzw9Zi/IAk=; b=pgma0m5GCu7Ts1jgwCsEv2CZFaXkcYFnYwXRGzFdgxijx4O7LWqILSFZeh8PVCnh7T ocHOUGgKFs+141+Ef8dXgRGZQuWsgKIhBYDgZ9/7Oto9c7v2aFE1NVq1smXLebs+HPJK FPyQKpI3lqbH2L5cNmcobspG1Oi4EmwFeKsxMxLNTh4xTCJtF4pTpWWSuMB3rnIaIHB8 /pQNSj9Sd79R+4DR5rQmU+PsoJCg74iqCCOd2FyuOhJq8MjBSJNlaC5s0pgqUe7E6c8k /f4ZNbPqAFeYag6gTWMBgpFqTiuar+8tOvBiiMQgSRASZ21PW9QvfGvQupdBnA0X77qo 1rxw== X-Gm-Message-State: AFqh2ko8FWCbAARMSI8IBngG6zFWlFsrp0dOMHxwYD+Vx1kVYEpw6UVv eDVNDsaGxJ5twA/MYTxTZP3s5pyxF/+t0Q== X-Google-Smtp-Source: AMrXdXuO+A7lDTkrmVidT0vNJ4k1azAFrpLFpVxinqKEQbcaPyL+4DQ2VBKz97wgvNH7CgXtTNREjA== X-Received: by 2002:a17:90a:1347:b0:229:a2:a265 with SMTP id y7-20020a17090a134700b0022900a2a265mr15325713pjf.3.1673841662605; Sun, 15 Jan 2023 20:01: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 nv7-20020a17090b1b4700b00212cf2fe8c3sm14257752pjb.1.2023.01.15.20.01.01 for <60846@debbugs.gnu.org> (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 15 Jan 2023 20:01:01 -0800 (PST) Content-Type: multipart/mixed; boundary="------------UQ5ljkgAhUDnq5k4wcYHgRE2" Message-ID: Date: Sun, 15 Jan 2023 20:01:01 -0800 MIME-Version: 1.0 Content-Language: en-US From: Jim Porter References: In-Reply-To: X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) This is a multi-part message in MIME format. --------------UQ5ljkgAhUDnq5k4wcYHgRE2 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Oops. Forgot to save the file, so I missed part of my update in the patch. Fixed here. --------------UQ5ljkgAhUDnq5k4wcYHgRE2 Content-Type: text/plain; charset=UTF-8; name="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.patch" Content-Disposition: attachment; filename*0="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.pat"; filename*1="ch" Content-Transfer-Encoding: base64 RnJvbSBlMmU5ZTMyNTdjZGQ1ZmRlMTI1NmQ4YTA5MzdjYTdiMmM2ODAwNTg4IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgMTUgSmFuIDIwMjMgMTg6MzU6MzEgLTA4MDAKU3ViamVjdDogW1BB VENIXSBBZGQgbW9yZSBkZXRhaWwgYWJvdXQgaG93IHRvIGludm9rZSBFc2hlbGwgY29tbWFu ZHMKCiogZG9jL21pc2MvZXNoZWxsLnRleGkgKENvbW1hbmRzKTogTW92ZSBleHBsYW5hdGlv biBhYm91dCBrZXJuZWwKZnVuY3Rpb25zIHRvIGhlcmUuCihJbnZvY2F0aW9uKTogRGVzY3Jp YmUgY29tbWFuZCBmb3JtIGFuZCBMaXNwIGZvcm0uICBGaXggZG9jdW1lbnRhdGlvbgphYm91 dCBwcmlvcml0eSBvZiBjb21tYW5kcyBpbiBjb21tYW5kIGZvcm0uCi0tLQogZG9jL21pc2Mv ZXNoZWxsLnRleGkgfCAxMDMgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrLS0t LS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDgwIGluc2VydGlvbnMoKyksIDIzIGRlbGV0aW9u cygtKQoKZGlmZiAtLWdpdCBhL2RvYy9taXNjL2VzaGVsbC50ZXhpIGIvZG9jL21pc2MvZXNo ZWxsLnRleGkKaW5kZXggZmM3ZDUyZWI3MTEuLjJlODcwMzA1OWYxIDEwMDY0NAotLS0gYS9k b2MvbWlzYy9lc2hlbGwudGV4aQorKysgYi9kb2MvbWlzYy9lc2hlbGwudGV4aQpAQCAtMTkz LDYgKzE5MywxMiBAQCBDb21tYW5kcwogY2hhcHRlciBjb3ZlcnMgY29tbWFuZCBpbnZvY2F0 aW9ucyBpbiBFc2hlbGwsIGluY2x1ZGluZyB0aGUgY29tbWFuZAogaGlzdG9yeSBhbmQgaW52 b2tpbmcgY29tbWFuZHMgaW4gYSBzY3JpcHQgZmlsZS4KIAorVW5saWtlIHJlZ3VsYXIgc3lz dGVtIHNoZWxscywgRXNoZWxsIG5ldmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucworZGly ZWN0bHksIHN1Y2ggYXMgQGNvZGV7ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBM aXNwIGZ1bmN0aW9ucworYXZhaWxhYmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJ dCBkb2VzIHRoaXMgYnkgdHJhbnNmb3JtaW5nIHRoZQoraW5wdXQgbGluZSBpbnRvIGEgY2Fs bGFibGUgTGlzcCBmb3JtLkBmb290bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybQordGhhdCB3 aWxsIGJlIGludm9rZWQsIHR5cGU6IEBzYW1we2VzaGVsbC1wYXJzZS1jb21tYW5kICdlY2hv IGhlbGxvJ319CisKIEBtZW51CiAqIEludm9jYXRpb246OgogKiBBcmd1bWVudHM6OgpAQCAt MjA3LDIzICsyMTMsMTYgQEAgQ29tbWFuZHMKIAogQG5vZGUgSW52b2NhdGlvbgogQHNlY3Rp b24gSW52b2NhdGlvbgotVW5saWtlIHJlZ3VsYXIgc3lzdGVtIHNoZWxscywgRXNoZWxsIG5l dmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucwotZGlyZWN0bHksIHN1Y2ggYXMgQGNvZGV7 ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBMaXNwIGZ1bmN0aW9ucwotYXZhaWxh YmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJdCBkb2VzIHRoaXMgYnkgdHJhbnNm b3JtaW5nIHRoZQotaW5wdXQgbGluZSBpbnRvIGEgY2FsbGFibGUgTGlzcCBmb3JtLkBmb290 bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybSB0aGF0IHdpbGwgYmUgaW52b2tlZCwgdHlwZTog QHNhbXB7ZXNoZWxsLXBhcnNlLWNvbW1hbmQgImVjaG8gaGVsbG8ifX0KK0VzaGVsbCBpcyBi b3RoIGEgY29tbWFuZCBzaGVsbCBhbmQgYW4gRW1hY3MgTGlzcCBAYWNyb255bXtSRVBMfS4g IEFzIGEKK3Jlc3VsdCwgeW91IGNhbiBpbnZva2UgY29tbWFuZHMgaW4gdHdvIGRpZmZlcmVu dCB3YXlzOiBpbiBAZGZue2NvbW1hbmQKK2Zvcm19IG9yIGluIEBkZm57bGlzcCBmb3JtfS4K IAotVGhlIGNvbW1hbmQgY2FuIGJlIGVpdGhlciBhbiBFbGlzcCBmdW5jdGlvbiBvciBhbiBl eHRlcm5hbCBjb21tYW5kLgotRXNoZWxsIGxvb2tzIGZpcnN0IGZvciBhbiBhbGlhcyAoQHB4 cmVme0FsaWFzZXN9KSB3aXRoIHRoZSBzYW1lIG5hbWUgYXMgdGhlCi1jb21tYW5kLCB0aGVu IGEgYnVpbHQtaW4gKEBweHJlZntCdWlsdC1pbnN9KSBvciBhIGZ1bmN0aW9uIHdpdGggdGhl Ci1zYW1lIG5hbWU7IGlmIHRoZXJlIGlzIG5vIG1hdGNoLCBpdCB0aGVuIHRyaWVzIHRvIGV4 ZWN1dGUgaXQgYXMgYW4KLWV4dGVybmFsIGNvbW1hbmQuCi0KLVRoZSBzZW1pY29sb24gKEBj b2Rlezt9KSBjYW4gYmUgdXNlZCB0byBzZXBhcmF0ZSBtdWx0aXBsZSBjb21tYW5kCi1pbnZv Y2F0aW9ucyBvbiBhIHNpbmdsZSBsaW5lLiAgWW91IGNhbiBhbHNvIHNlcGFyYXRlIGNvbW1h bmRzIHdpdGgKLUBjb2RleyYmfSBvciBAY29kZXt8fH0uIFdoZW4gdXNpbmcgQGNvZGV7JiZ9 LCBFc2hlbGwgd2lsbCBleGVjdXRlIHRoZQotc2Vjb25kIGNvbW1hbmQgb25seSBpZiB0aGUg Zmlyc3Qgc3VjY2VlZHMgKGkuZS5AOiBoYXMgYW4gZXhpdAotc3RhdHVzIG9mIDApOyB3aXRo IEBjb2Rle3x8fSwgRXNoZWxsIHdpbGwgZXhlY3V0ZSB0aGUgc2Vjb25kIGNvbW1hbmQKLW9u bHkgaWYgdGhlIGZpcnN0IGZhaWxzLgorWW91IGNhbiB1c2UgdGhlIHNlbWljb2xvbiAoQGNv ZGV7O30pIHRvIHNlcGFyYXRlIG11bHRpcGxlIGNvbW1hbmQKK2ludm9jYXRpb25zIG9uIGEg c2luZ2xlIGxpbmUsIGV4ZWN1dGluZyBlYWNoIGluIHR1cm4uICBZb3UgY2FuIGFsc28KK3Nl cGFyYXRlIGNvbW1hbmRzIHdpdGggQGNvZGV7JiZ9IG9yIEBjb2Rle3x8fS4gV2hlbiB1c2lu ZyBAY29kZXsmJn0sCitFc2hlbGwgd2lsbCBleGVjdXRlIHRoZSBzZWNvbmQgY29tbWFuZCBv bmx5IGlmIHRoZSBmaXJzdCBzdWNjZWVkcworKGkuZS5AOiBoYXMgYW4gZXhpdCBzdGF0dXMg b2YgMCk7IHdpdGggQGNvZGV7fHx9LCBFc2hlbGwgd2lsbCBleGVjdXRlCit0aGUgc2Vjb25k IGNvbW1hbmQgb25seSBpZiB0aGUgZmlyc3QgZmFpbHMuCiAKIEEgY29tbWFuZCBpbnZvY2F0 aW9uIGZvbGxvd2VkIGJ5IGFuIGFtcGVyc2FuZCAoQGNvZGV7Jn0pIHdpbGwgYmUgcnVuCiBp biB0aGUgYmFja2dyb3VuZC4gIEVzaGVsbCBoYXMgbm8gam9iIGNvbnRyb2wsIHNvIHlvdSBj YW4gbm90IHN1c3BlbmQKQEAgLTIzMiwxMiArMjMxLDc0IEBAIEludm9jYXRpb24KIGNhbiBi ZSBjb250cm9sbGVkIHRoZSBzYW1lIHdheSBhcyBhbnkgb3RoZXIgYmFja2dyb3VuZCBwcm9j ZXNzIGluCiBFbWFjcy4KIAorQHN1YnNlY3Rpb24gQ29tbWFuZCBmb3JtCitDb21tYW5kIGZv cm0gbG9va3MgbXVjaCB0aGUgc2FtZSBhcyBpbiBvdGhlciBzaGVsbHMuICBBIGNvbW1hbmQK K2NvbnNpc3RzIG9mIGFyZ3VtZW50cyBzZXBhcmF0ZWQgYnkgc3BhY2VzOyB0aGUgZmlyc3Qg YXJndW1lbnQgaXMgdGhlCitjb21tYW5kIHRvIHJ1biwgd2l0aCBhbnkgc3Vic2VxdWVudCBh cmd1bWVudHMgYmVpbmcgcGFzc2VkIHRvIHRoYXQKK2NvbW1hbmQuCisKK0BleGFtcGxlCit+ ICQgZWNobyBoZWxsbworaGVsbG8KK0BlbmQgZXhhbXBsZQorCitUaGUgY29tbWFuZCBjYW4g YmUgZWl0aGVyIGFuIEVsaXNwIGZ1bmN0aW9uIG9yIGFuIGV4dGVybmFsIGNvbW1hbmQuCitF c2hlbGwgbG9va3MgZm9yIHRoZSBjb21tYW5kIGluIHRoZSBmb2xsb3dpbmcgb3JkZXI6CisK K0BlbnVtZXJhdGUKK0BpdGVtCitBcyBhIGNvbW1hbmQgYWxpYXMgKEBweHJlZntBbGlhc2Vz fSkKKworQGl0ZW0KK0FzIGEgYnVpbHQtaW4gY29tbWFuZCAoQHB4cmVme0J1aWx0LWluc30p CisKK0BpdGVtCitBcyBhbiBleHRlcm5hbCBwcm9ncmFtCisKK0BpdGVtCitBcyBhbiBvcmRp bmFyeSBMaXNwIGZ1bmN0aW9uCitAZW5kIGVudW1lcmF0ZQorCitAdmluZGV4IGVzaGVsbC1w cmVmZXItbGlzcC1mdW5jdGlvbnMKK0lmIHlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIG9yZGlu YXJ5IExpc3AgZnVuY3Rpb25zIG92ZXIgZXh0ZXJuYWwKK3Byb2dyYW1zLCBzZXQgdGhlIG9w dGlvbiBAY29kZXtlc2hlbGwtcHJlZmVyLWxpc3AtZnVuY3Rpb25zfSB0bworQGNvZGV7dH0u CisKK1lvdSBjYW4gYWxzbyBncm91cCBjb21tYW5kIGZvcm1zIHRvZ2V0aGVyIGludG8gYSBz dWJjb21tYW5kIHdpdGggY3VybHkKK2JyYWNlcyAoQGNvZGV7QHtAfX0pLiAgVGhpcyBsZXRz IHlvdSB1c2UgdGhlIG91dHB1dCBvZiBhIHN1YmNvbW1hbmQgYXMKK2FuIGFyZ3VtZW50IHRv IGFub3RoZXIgY29tbWFuZCwgb3Igd2l0aGluIGNvbnRyb2wgZmxvdyBzdGF0ZW1lbnRzCiso QHB4cmVme0NvbnRyb2wgRmxvd30pLgorCitAZXhhbXBsZQorfiAkIGVjaG8gQHtlY2hvIGhl bGxvOyBlY2hvIHRoZXJlQH0KK2hlbGxvdGhlcmUKK0BlbmQgZXhhbXBsZQorCitAc3Vic2Vj dGlvbiBMaXNwIGZvcm0KK0xpc3AgZm9ybSBsb29rcyBsaWtlIG9yZGluYXJ5IEVtYWNzIExp c3AgY29kZSwgYmVjYXVzZSB0aGF0J3Mgd2hhdCBpdAoraXMuICBBcyBhIHJlc3VsdCwgeW91 IGNhbiB1c2UgYW55IHN5bnRheCBub3JtYWxseSBhdmFpbGFibGUgdG8gYW4KK0VtYWNzIExp c3AgcHJvZ3JhbSAoQHB4cmVme1RvcCwgLCAsIGVsaXNwLCBUaGUgRW1hY3MgTGlzcCBSZWZl cmVuY2UKK01hbnVhbH0pLgorCitAZXhhbXBsZQorfiAkIChmb3JtYXQgImhlbGxvLCAlcyIg dXNlci1sb2dpbi1uYW1lKQoraGVsbG8sIHVzZXIKK0BlbmQgZXhhbXBsZQorCitJbiBhZGRp dGlvbiwgeW91IGNhbiBAZW1waHtjb21iaW5lfSBjb21tYW5kIGZvcm1zIGFuZCBMaXNwIGZv cm1zCit0b2dldGhlciBpbnRvIHNpbmdsZSBzdGF0ZW1lbnRzLCBsZXR0aW5nIHlvdSB1c2Ug d2hhdGV2ZXIgZm9ybSBpcyB0aGUKK21vc3QgY29udmVuaWVudCBmb3IgZXhwcmVzc2luZyB5 b3VyIGludGVudGlvbnMuCisKK0BleGFtcGxlCit+ICQgbHMgKi5wYXRjaCA+IChmb3JtYXQt dGltZS1zdHJpbmcgIiVGLmxvZyIpCitAZW5kIGV4YW1wbGUKKwogQG5vZGUgQXJndW1lbnRz CiBAc2VjdGlvbiBBcmd1bWVudHMKLU9yZGluYXJpbHksIGNvbW1hbmQgYXJndW1lbnRzIGFy ZSBwYXJzZWQgYnkgRXNoZWxsIGFzIGVpdGhlciBzdHJpbmdzCitPcmRpbmFyaWx5LCBFc2hl bGwgcGFyc2VzIGFyZ3VtZW50cyBpbiBjb21tYW5kIGZvcm0gYXMgZWl0aGVyIHN0cmluZ3MK IG9yIG51bWJlcnMsIGRlcGVuZGluZyBvbiB3aGF0IHRoZSBwYXJzZXIgdGhpbmtzIHRoZXkg bG9vayBsaWtlLiAgVG8KLXNwZWNpZnkgYW4gYXJndW1lbnQgb2Ygc29tZSBvdGhlciBkYXRh IHR5cGUsIHlvdSBjYW4gdXNlIGFuCi1AcmVme0RvbGxhcnMgRXhwYW5zaW9uLCBFbGlzcCBl eHByZXNzaW9ufToKK3NwZWNpZnkgYW4gYXJndW1lbnQgb2Ygc29tZSBvdGhlciBkYXRhIHR5 cGUsIHlvdSBjYW4gdXNlIGEKK0ByZWZ7SW52b2NhdGlvbiwgTGlzcCBmb3JtfToKIAogQGV4 YW1wbGUKIH4gJCBlY2hvIChsaXN0IDEgMiAzKQpAQCAtMzU0LDEwICs0MTUsNiBAQCBCdWls dC1pbnMKIHN1ZG8gaXMgYW4gYWxpYXMsIGRlZmluZWQgYXMgIipzdWRvICRAQCoiCiBAZW5k IGV4YW1wbGUKIAotQHZpbmRleCBlc2hlbGwtcHJlZmVyLWxpc3AtZnVuY3Rpb25zCi1JZiB5 b3Ugd291bGQgcHJlZmVyIHRvIHVzZSB0aGUgYnVpbHQtaW4gY29tbWFuZHMgaW5zdGVhZCBv ZiB0aGUgZXh0ZXJuYWwKLWNvbW1hbmRzLCBzZXQgQGNvZGV7ZXNoZWxsLXByZWZlci1saXNw LWZ1bmN0aW9uc30gdG8gQGNvZGV7dH0uCi0KIFNvbWUgb2YgdGhlIGJ1aWx0LWluIGNvbW1h bmRzIGhhdmUgZGlmZmVyZW50IGJlaGF2aW9yIGZyb20gdGhlaXIKIGV4dGVybmFsIGNvdW50 ZXJwYXJ0cywgYW5kIHNvbWUgaGF2ZSBubyBleHRlcm5hbCBjb3VudGVycGFydC4gIE1vc3Qg b2YKIHRoZXNlIHdpbGwgcHJpbnQgYSB1c2FnZSBtZXNzYWdlIHdoZW4gZ2l2ZW4gdGhlIEBj b2Rley0taGVscH0gb3B0aW9uLgotLSAKMi4yNS4xCgo= --------------UQ5ljkgAhUDnq5k4wcYHgRE2-- From unknown Fri Jun 13 11:34:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2023 13:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60846 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Jim Porter Cc: 60846@debbugs.gnu.org Received: via spool by 60846-submit@debbugs.gnu.org id=B60846.16738762979307 (code B ref 60846); Mon, 16 Jan 2023 13:39:02 +0000 Received: (at 60846) by debbugs.gnu.org; 16 Jan 2023 13:38:17 +0000 Received: from localhost ([127.0.0.1]:60819 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHPgn-0002Q3-Bn for submit@debbugs.gnu.org; Mon, 16 Jan 2023 08:38:17 -0500 Received: from eggs.gnu.org ([209.51.188.92]:48710) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHPgl-0002Pr-Ij for 60846@debbugs.gnu.org; Mon, 16 Jan 2023 08:38:16 -0500 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 ) id 1pHPgg-0002op-1S; Mon, 16 Jan 2023 08:38:10 -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=EuwMkAUee5M7oxPKl3plEzx2O7IL0yVKuKlcoij/hH8=; b=n820A2VCsLC/ uwkYNkSsh9O6Pd3nTaHQ2yzD/ptsn6JOAzLKIZ6AbmAatvmRBYc7eQqSFngeehQXwnrm1b+rLbquK 3ywGLRrTWFp90oc3u2dYpVi+0nUi7RvrX4Z5iAqD9mLXzBKfbt3ILL6kOfGyw9jTepmRTBaHRqTLs ssU9riaxbfOWsvX7LKCWeZ7gjPvW5AH7+9eSsTplMtPF9mqbaEhNy/pxMMzZwHD8YfXm6woLUVqpy QrPFh2Y2GTd+Y0Kg/Ekr3wt0XfxXxj3u/cR8AgLyr6XFDVcFI0nRxuQnw3LcuKu1NHrMPGWj0006g /MsNp225Ft+1cihViyOupw==; Received: from [87.69.77.57] (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 1pHPge-00013y-Jx; Mon, 16 Jan 2023 08:38:09 -0500 Date: Mon, 16 Jan 2023 15:38:15 +0200 Message-Id: <83wn5m4n20.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Jim Porter on Sun, 15 Jan 2023 18:51:25 -0800) References: X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Sun, 15 Jan 2023 18:51:25 -0800 > From: Jim Porter > > The Eshell manual isn't as thorough as it could be about how users > should invoke commands. While there's a reasonable amount of > documentation about the details, it never directly describes how to run > a simple command. > > Attached is a patch to remedy this. I also corrected the documentation > about how Eshell picks what command to run in command form; previously, > it stated that ordinary Lisp functions had higher priority than external > commands, which isn't actually the case (unless you set > 'eshell-prefer-lisp-functions'). Thanks. > Since this is purely a documentation change, I'd like to merge this to > the Emacs 29 branch. That's fine. > +Unlike regular system shells, Eshell never invokes kernel functions > +directly, such as @code{exec(3)}. Instead, it uses the Lisp functions > +available in the Emacs Lisp library. It does this by transforming the > +input line into a callable Lisp form.@footnote{To see the Lisp form > +that will be invoked, type: @samp{eshell-parse-command 'echo hello'}} This should use the @kbd markup, like any command the user should type. I also suggest to say explicitly that you mean to type this at the Eshell prompt, as it wasn't clear when I read it. > +The command can be either an Elisp function or an external command. > +Eshell looks for the command in the following order: Here I would add a few useful index entries @cindex order of looking for commands @cindex command look up, order > +@vindex eshell-prefer-lisp-functions > +If you would prefer to use ordinary Lisp functions over external > +programs, set the option @code{eshell-prefer-lisp-functions} to > +@code{t}. I'm guessing this swaps the order of the two last candidates, but the text doesn't say that explicitly for some reason. Just saying "prefer" is not enough when you have more than 2 candidates. > +In addition, you can @emph{combine} command forms and Lisp forms > +together into single statements, letting you use whatever form is the > +most convenient for expressing your intentions. > + > +@example > +~ $ ls *.patch > (format-time-string "%F.log") > +@end example Either explain here the meaning of redirecting into a Lisp form, or add a cross-reference to where it is explained in detail. > +specify an argument of some other data type, you can use a > +@ref{Invocation, Lisp form}: This kind of cross-references is usually a bad idea in Texinfo: it looks nifty in HTML, but reads awkwardly in all other formats. It is better to use the slightly wordier alternative: specify an argument of some other data type, you can use a Lisp form (@pxref{Invocation}): From unknown Fri Jun 13 11:34:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Resent-From: Jim Porter Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2023 20:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60846 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 60846@debbugs.gnu.org Received: via spool by 60846-submit@debbugs.gnu.org id=B60846.16739003041134 (code B ref 60846); Mon, 16 Jan 2023 20:19:02 +0000 Received: (at 60846) by debbugs.gnu.org; 16 Jan 2023 20:18:24 +0000 Received: from localhost ([127.0.0.1]:34929 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHVvz-0000IC-M2 for submit@debbugs.gnu.org; Mon, 16 Jan 2023 15:18:24 -0500 Received: from mail-pg1-f170.google.com ([209.85.215.170]:35713) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHVvx-0000Hx-61 for 60846@debbugs.gnu.org; Mon, 16 Jan 2023 15:18:22 -0500 Received: by mail-pg1-f170.google.com with SMTP id f3so20411070pgc.2 for <60846@debbugs.gnu.org>; Mon, 16 Jan 2023 12:18:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:from:references:cc:to:content-language:subject :mime-version:date:message-id:from:to:cc:subject:date:message-id :reply-to; bh=sI8FSJXlwsRc66cULYBbv3sWgpqpFJdEbrdtKIB8uAk=; b=DKtfuzt9iPmzxZCLlq/paONgAhCha9PnTYW5PkBXP6R6Uanxz0Vz+L5NFlpWhrE39n yS/qWB4DuCmwJhzZdWDPEQgd5GTwxN++IdNlu824dwZvoCF1ntRo4ylf3IgbO5yAgSJg x8WybtMjswn5fWLFabnotp49Uh6rWqpfV42+MseoYvelF0fhKdNfa5AFC02vE8fmfikh r1fugN57wKHeDEwuRPDpMX/pDiz4oZxCyxBVsfQvpMx4DWba9sWG3PGKybtdviWPBE6s 8g6tulmJ8OlGAbUiFytk1a1F6jBrwOYCxv3AqVy3lDWhuryw/1IB9fmO/vBiZ9kuey0D KtrQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:from:references:cc:to:content-language:subject :mime-version:date:message-id:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=sI8FSJXlwsRc66cULYBbv3sWgpqpFJdEbrdtKIB8uAk=; b=yAg2WOnj9LSGnrSGwgQA7pLFGQlzKluyooehcuwwmBTZUE1nPnhALdB87ZX28rONs4 dnnAEXxkrz6jHqRvqAOCSNzJVPpo4mDaejGfsSyZQuFGA6d4AkM3vl+d4/nL3JgsQyb5 TL+8O9bNyLBW0mQySMZE7ArgiubPzpt+AQesRF+YNTGHRcNwOJjbnOzq7d2ZSQAVzMez R/Y3rvVwVK3oSAX5X05nOUKXnh8KszzXhJEvinUTcZFEepkFJJ2j1RE//Zq9hDXF0pVC k+1Q3M34VTZT1qYM6ldqAXbFl0md3/e0GQ3dQ7fjwaePi8rsvpyUVERKiHpdKrnfeEfj 9S2A== X-Gm-Message-State: AFqh2kq00+OVTiWOo7B2E4nVMtJ3vgSZbg+hI+K8uKt2tXGB8chLx1Ts jDMllxybxe15v3IbA350id25shVVXMeNeA== X-Google-Smtp-Source: AMrXdXtAT2xZuJHGTcPh4rGzdFb+DN5FNJlH3WnePMtXZCncT1IkVpfmlTUYlAZzqbbpgMB7HgLGKQ== X-Received: by 2002:a05:6a00:26cc:b0:589:62bd:14d with SMTP id p12-20020a056a0026cc00b0058962bd014dmr833468pfw.1.1673900295096; Mon, 16 Jan 2023 12:18:15 -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 w124-20020a626282000000b005769b23260fsm19102603pfb.18.2023.01.16.12.18.13 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 16 Jan 2023 12:18:14 -0800 (PST) Content-Type: multipart/mixed; boundary="------------TiW00q0gddILaqBhLwSmfJql" Message-ID: <57aba6cb-7730-cd59-cdc7-94058596f74e@gmail.com> Date: Mon, 16 Jan 2023 12:18:13 -0800 MIME-Version: 1.0 Content-Language: en-US References: <83wn5m4n20.fsf@gnu.org> From: Jim Porter In-Reply-To: <83wn5m4n20.fsf@gnu.org> X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) This is a multi-part message in MIME format. --------------TiW00q0gddILaqBhLwSmfJql Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 1/16/2023 5:38 AM, Eli Zaretskii wrote: > Thanks. Thanks for the useful feedback as always. >> +Unlike regular system shells, Eshell never invokes kernel functions >> +directly, such as @code{exec(3)}. Instead, it uses the Lisp functions >> +available in the Emacs Lisp library. It does this by transforming the >> +input line into a callable Lisp form.@footnote{To see the Lisp form >> +that will be invoked, type: @samp{eshell-parse-command 'echo hello'}} > > This should use the @kbd markup, like any command the user should > type. I also suggest to say explicitly that you mean to type this at > the Eshell prompt, as it wasn't clear when I read it. Fixed. >> +The command can be either an Elisp function or an external command. >> +Eshell looks for the command in the following order: > > Here I would add a few useful index entries > > @cindex order of looking for commands > @cindex command look up, order Done. >> +@vindex eshell-prefer-lisp-functions >> +If you would prefer to use ordinary Lisp functions over external >> +programs, set the option @code{eshell-prefer-lisp-functions} to >> +@code{t}. > > I'm guessing this swaps the order of the two last candidates, but the > text doesn't say that explicitly for some reason. Just saying > "prefer" is not enough when you have more than 2 candidates. Good point. I added an extra sentence explicitly stating that the last two items are swapped in priority. >> +In addition, you can @emph{combine} command forms and Lisp forms >> +together into single statements, letting you use whatever form is the >> +most convenient for expressing your intentions. >> + >> +@example >> +~ $ ls *.patch > (format-time-string "%F.log") >> +@end example > > Either explain here the meaning of redirecting into a Lisp form, or > add a cross-reference to where it is explained in detail. Done both. I've explained what the command does as well as cross-referenced the globbing and redirection sections. >> +specify an argument of some other data type, you can use a >> +@ref{Invocation, Lisp form}: > > This kind of cross-references is usually a bad idea in Texinfo: it > looks nifty in HTML, but reads awkwardly in all other formats. It is > better to use the slightly wordier alternative: > > specify an argument of some other data type, you can use a Lisp form > (@pxref{Invocation}): Ah ha, I didn't realize. Fixed. --------------TiW00q0gddILaqBhLwSmfJql Content-Type: text/plain; charset=UTF-8; name="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.patch" Content-Disposition: attachment; filename*0="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.pat"; filename*1="ch" Content-Transfer-Encoding: base64 RnJvbSA3ZjQwODk5NzVmYjM4OTRjYjlhZjVlNWU3OTEzMTQxMzg1ZDgyM2U2IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgMTUgSmFuIDIwMjMgMTg6MzU6MzEgLTA4MDAKU3ViamVjdDogW1BB VENIXSBBZGQgbW9yZSBkZXRhaWwgYWJvdXQgaG93IHRvIGludm9rZSBFc2hlbGwgY29tbWFu ZHMKCiogZG9jL21pc2MvZXNoZWxsLnRleGkgKFZhcmlhYmxlcyk6IE1vdmUgZm9vdG5vdGUg ZXhwbGFpbmluZyAiUkVQTCIKZnJvbSBoZXJlLi4uCihUb3ApOiAuLi4gdG8gaXRzIGZpcnN0 IHVzZSBoZXJlLgooQ29tbWFuZHMpOiBNb3ZlIGV4cGxhbmF0aW9uIGFib3V0IGtlcm5lbCBm dW5jdGlvbnMgdG8gaGVyZS4KKEludm9jYXRpb24pOiBEZXNjcmliZSBjb21tYW5kIGZvcm0g YW5kIExpc3AgZm9ybS4gIEZpeCBkb2N1bWVudGF0aW9uCmFib3V0IHByaW9yaXR5IG9mIGNv bW1hbmRzIGluIGNvbW1hbmQgZm9ybS4KKEFyZ3VtZW50cyk6IEFkZCBhIGNyb3NzIHJlZmVy ZW5jZSB0byB0aGUgSW52b2NhdGlvbiBub2RlLgotLS0KIGRvYy9taXNjL2VzaGVsbC50ZXhp IHwgMTM2ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLS0tLS0tLS0KIDEg ZmlsZSBjaGFuZ2VkLCAxMDAgaW5zZXJ0aW9ucygrKSwgMzYgZGVsZXRpb25zKC0pCgpkaWZm IC0tZ2l0IGEvZG9jL21pc2MvZXNoZWxsLnRleGkgYi9kb2MvbWlzYy9lc2hlbGwudGV4aQpp bmRleCBmYzdkNTJlYjcxMS4uZWNjN2JjM2EwMTEgMTAwNjQ0Ci0tLSBhL2RvYy9taXNjL2Vz aGVsbC50ZXhpCisrKyBiL2RvYy9taXNjL2VzaGVsbC50ZXhpCkBAIC02NCwxMCArNjQsMTEg QEAgVG9wCiAKIEVzaGVsbCBpcyBhIHNoZWxsLWxpa2UgY29tbWFuZCBpbnRlcnByZXRlciBp bXBsZW1lbnRlZCBpbiBFbWFjcyBMaXNwLgogSXQgaW52b2tlcyBubyBleHRlcm5hbCBwcm9j ZXNzZXMgZXhjZXB0IGZvciB0aG9zZSByZXF1ZXN0ZWQgYnkgdGhlCi11c2VyLiAgSXQgaXMg aW50ZW5kZWQgdG8gYmUgYW4gYWx0ZXJuYXRpdmUgdG8gdGhlIElFTE0gKEBweHJlZntMaXNw IEludGVyYWN0aW9uLCBFbWFjcyBMaXNwIEludGVyYWN0aW9uLCAsIGVtYWNzLCBUaGUgRW1h Y3MgRWRpdG9yfSkKLVJFUEwgZm9yIEVtYWNzIEBlbXBoe2FuZH0gd2l0aCBhbiBpbnRlcmZh Y2Ugc2ltaWxhciB0byBjb21tYW5kIHNoZWxscwotc3VjaCBhcyBAY29tbWFuZHtiYXNofSwg QGNvbW1hbmR7enNofSwgQGNvbW1hbmR7cmN9LCBvcgotQGNvbW1hbmR7NGRvc30uCit1c2Vy LiAgSXQgaXMgaW50ZW5kZWQgdG8gYmUgYW4gYWx0ZXJuYXRpdmUgdG8gdGhlIElFTE0gKEBw eHJlZntMaXNwCitJbnRlcmFjdGlvbiwgRW1hY3MgTGlzcCBJbnRlcmFjdGlvbiwgLCBlbWFj cywgVGhlIEVtYWNzIEVkaXRvcn0pCitSRVBMQGZvb3Rub3Rle1Nob3J0IGZvciBgYFJlYWQt RXZhbC1QcmludCBMb29wJycufSBmb3IgRW1hY3MKK0BlbXBoe2FuZH0gd2l0aCBhbiBpbnRl cmZhY2Ugc2ltaWxhciB0byBjb21tYW5kIHNoZWxscyBzdWNoIGFzCitAY29tbWFuZHtiYXNo fSwgQGNvbW1hbmR7enNofSwgQGNvbW1hbmR7cmN9LCBvciBAY29tbWFuZHs0ZG9zfS4KIEBj IFRoaXMgbWFudWFsIGlzIHVwZGF0ZWQgdG8gcmVsZWFzZSAyLjQgb2YgRXNoZWxsLgogCiBA aW5zZXJ0Y29weWluZwpAQCAtMTkzLDYgKzE5NCwxMyBAQCBDb21tYW5kcwogY2hhcHRlciBj b3ZlcnMgY29tbWFuZCBpbnZvY2F0aW9ucyBpbiBFc2hlbGwsIGluY2x1ZGluZyB0aGUgY29t bWFuZAogaGlzdG9yeSBhbmQgaW52b2tpbmcgY29tbWFuZHMgaW4gYSBzY3JpcHQgZmlsZS4K IAorVW5saWtlIHJlZ3VsYXIgc3lzdGVtIHNoZWxscywgRXNoZWxsIG5ldmVyIGludm9rZXMg a2VybmVsIGZ1bmN0aW9ucworZGlyZWN0bHksIHN1Y2ggYXMgQGNvZGV7ZXhlYygzKX0uICBJ bnN0ZWFkLCBpdCB1c2VzIHRoZSBMaXNwIGZ1bmN0aW9ucworYXZhaWxhYmxlIGluIHRoZSBF bWFjcyBMaXNwIGxpYnJhcnkuICBJdCBkb2VzIHRoaXMgYnkgdHJhbnNmb3JtaW5nIHRoZQor aW5wdXQgbGluZSBpbnRvIGEgY2FsbGFibGUgTGlzcCBmb3JtLkBmb290bm90ZXtUbyBzZWUg dGhlIExpc3AgZm9ybQordGhhdCB3aWxsIGJlIGludm9rZWQsIHR5cGUgdGhpcyBhcyB0aGUg RXNoZWxsIHByb21wdDoKK0BrYmR7ZXNoZWxsLXBhcnNlLWNvbW1hbmQgJ2VjaG8gaGVsbG8n fX0KKwogQG1lbnUKICogSW52b2NhdGlvbjo6CiAqIEFyZ3VtZW50czo6CkBAIC0yMDcsMjMg KzIxNSwxNiBAQCBDb21tYW5kcwogCiBAbm9kZSBJbnZvY2F0aW9uCiBAc2VjdGlvbiBJbnZv Y2F0aW9uCi1Vbmxpa2UgcmVndWxhciBzeXN0ZW0gc2hlbGxzLCBFc2hlbGwgbmV2ZXIgaW52 b2tlcyBrZXJuZWwgZnVuY3Rpb25zCi1kaXJlY3RseSwgc3VjaCBhcyBAY29kZXtleGVjKDMp fS4gIEluc3RlYWQsIGl0IHVzZXMgdGhlIExpc3AgZnVuY3Rpb25zCi1hdmFpbGFibGUgaW4g dGhlIEVtYWNzIExpc3AgbGlicmFyeS4gIEl0IGRvZXMgdGhpcyBieSB0cmFuc2Zvcm1pbmcg dGhlCi1pbnB1dCBsaW5lIGludG8gYSBjYWxsYWJsZSBMaXNwIGZvcm0uQGZvb3Rub3Rle1Rv IHNlZSB0aGUgTGlzcCBmb3JtIHRoYXQgd2lsbCBiZSBpbnZva2VkLCB0eXBlOiBAc2FtcHtl c2hlbGwtcGFyc2UtY29tbWFuZCAiZWNobyBoZWxsbyJ9fQorRXNoZWxsIGlzIGJvdGggYSBj b21tYW5kIHNoZWxsIGFuZCBhbiBFbWFjcyBMaXNwIEBhY3Jvbnlte1JFUEx9LiAgQXMgYQor cmVzdWx0LCB5b3UgY2FuIGludm9rZSBjb21tYW5kcyBpbiB0d28gZGlmZmVyZW50IHdheXM6 IGluIEBkZm57Y29tbWFuZAorZm9ybX0gb3IgaW4gQGRmbntsaXNwIGZvcm19LgogCi1UaGUg Y29tbWFuZCBjYW4gYmUgZWl0aGVyIGFuIEVsaXNwIGZ1bmN0aW9uIG9yIGFuIGV4dGVybmFs IGNvbW1hbmQuCi1Fc2hlbGwgbG9va3MgZmlyc3QgZm9yIGFuIGFsaWFzIChAcHhyZWZ7QWxp YXNlc30pIHdpdGggdGhlIHNhbWUgbmFtZSBhcyB0aGUKLWNvbW1hbmQsIHRoZW4gYSBidWls dC1pbiAoQHB4cmVme0J1aWx0LWluc30pIG9yIGEgZnVuY3Rpb24gd2l0aCB0aGUKLXNhbWUg bmFtZTsgaWYgdGhlcmUgaXMgbm8gbWF0Y2gsIGl0IHRoZW4gdHJpZXMgdG8gZXhlY3V0ZSBp dCBhcyBhbgotZXh0ZXJuYWwgY29tbWFuZC4KLQotVGhlIHNlbWljb2xvbiAoQGNvZGV7O30p IGNhbiBiZSB1c2VkIHRvIHNlcGFyYXRlIG11bHRpcGxlIGNvbW1hbmQKLWludm9jYXRpb25z IG9uIGEgc2luZ2xlIGxpbmUuICBZb3UgY2FuIGFsc28gc2VwYXJhdGUgY29tbWFuZHMgd2l0 aAotQGNvZGV7JiZ9IG9yIEBjb2Rle3x8fS4gV2hlbiB1c2luZyBAY29kZXsmJn0sIEVzaGVs bCB3aWxsIGV4ZWN1dGUgdGhlCi1zZWNvbmQgY29tbWFuZCBvbmx5IGlmIHRoZSBmaXJzdCBz dWNjZWVkcyAoaS5lLkA6IGhhcyBhbiBleGl0Ci1zdGF0dXMgb2YgMCk7IHdpdGggQGNvZGV7 fHx9LCBFc2hlbGwgd2lsbCBleGVjdXRlIHRoZSBzZWNvbmQgY29tbWFuZAotb25seSBpZiB0 aGUgZmlyc3QgZmFpbHMuCitZb3UgY2FuIHVzZSB0aGUgc2VtaWNvbG9uIChAY29kZXs7fSkg dG8gc2VwYXJhdGUgbXVsdGlwbGUgY29tbWFuZAoraW52b2NhdGlvbnMgb24gYSBzaW5nbGUg bGluZSwgZXhlY3V0aW5nIGVhY2ggaW4gdHVybi4gIFlvdSBjYW4gYWxzbworc2VwYXJhdGUg Y29tbWFuZHMgd2l0aCBAY29kZXsmJn0gb3IgQGNvZGV7fHx9LiBXaGVuIHVzaW5nIEBjb2Rl eyYmfSwKK0VzaGVsbCB3aWxsIGV4ZWN1dGUgdGhlIHNlY29uZCBjb21tYW5kIG9ubHkgaWYg dGhlIGZpcnN0IHN1Y2NlZWRzCisoaS5lLkA6IGhhcyBhbiBleGl0IHN0YXR1cyBvZiAwKTsg d2l0aCBAY29kZXt8fH0sIEVzaGVsbCB3aWxsIGV4ZWN1dGUKK3RoZSBzZWNvbmQgY29tbWFu ZCBvbmx5IGlmIHRoZSBmaXJzdCBmYWlscy4KIAogQSBjb21tYW5kIGludm9jYXRpb24gZm9s bG93ZWQgYnkgYW4gYW1wZXJzYW5kIChAY29kZXsmfSkgd2lsbCBiZSBydW4KIGluIHRoZSBi YWNrZ3JvdW5kLiAgRXNoZWxsIGhhcyBubyBqb2IgY29udHJvbCwgc28geW91IGNhbiBub3Qg c3VzcGVuZApAQCAtMjMyLDEyICsyMzMsODAgQEAgSW52b2NhdGlvbgogY2FuIGJlIGNvbnRy b2xsZWQgdGhlIHNhbWUgd2F5IGFzIGFueSBvdGhlciBiYWNrZ3JvdW5kIHByb2Nlc3MgaW4K IEVtYWNzLgogCitAc3Vic2VjdGlvbiBDb21tYW5kIGZvcm0KK0NvbW1hbmQgZm9ybSBsb29r cyBtdWNoIHRoZSBzYW1lIGFzIGluIG90aGVyIHNoZWxscy4gIEEgY29tbWFuZAorY29uc2lz dHMgb2YgYXJndW1lbnRzIHNlcGFyYXRlZCBieSBzcGFjZXM7IHRoZSBmaXJzdCBhcmd1bWVu dCBpcyB0aGUKK2NvbW1hbmQgdG8gcnVuLCB3aXRoIGFueSBzdWJzZXF1ZW50IGFyZ3VtZW50 cyBiZWluZyBwYXNzZWQgdG8gdGhhdAorY29tbWFuZC4KKworQGV4YW1wbGUKK34gJCBlY2hv IGhlbGxvCitoZWxsbworQGVuZCBleGFtcGxlCisKK0BjaW5kZXggb3JkZXIgb2YgbG9va2lu ZyBmb3IgY29tbWFuZHMKK0BjaW5kZXggY29tbWFuZCBsb29rdXAgb3JkZXIKK1RoZSBjb21t YW5kIGNhbiBiZSBlaXRoZXIgYW4gRWxpc3AgZnVuY3Rpb24gb3IgYW4gZXh0ZXJuYWwgY29t bWFuZC4KK0VzaGVsbCBsb29rcyBmb3IgdGhlIGNvbW1hbmQgaW4gdGhlIGZvbGxvd2luZyBv cmRlcjoKKworQGVudW1lcmF0ZQorQGl0ZW0KK0FzIGEgY29tbWFuZCBhbGlhcyAoQHB4cmVm e0FsaWFzZXN9KQorCitAaXRlbQorQXMgYSBidWlsdC1pbiBjb21tYW5kIChAcHhyZWZ7QnVp bHQtaW5zfSkKKworQGl0ZW0KK0FzIGFuIGV4dGVybmFsIHByb2dyYW0KKworQGl0ZW0KK0Fz IGFuIG9yZGluYXJ5IExpc3AgZnVuY3Rpb24KK0BlbmQgZW51bWVyYXRlCisKK0B2aW5kZXgg ZXNoZWxsLXByZWZlci1saXNwLWZ1bmN0aW9ucworSWYgeW91IHdvdWxkIHByZWZlciB0byB1 c2Ugb3JkaW5hcnkgTGlzcCBmdW5jdGlvbnMgb3ZlciBleHRlcm5hbAorcHJvZ3JhbXMsIHNl dCB0aGUgb3B0aW9uIEBjb2Rle2VzaGVsbC1wcmVmZXItbGlzcC1mdW5jdGlvbnN9IHRvCitA Y29kZXt0fS4gIFRoaXMgd2lsbCBzd2FwIHRoZSBsb29rdXAgb3JkZXIgb2YgdGhlIGxhc3Qg dHdvIGl0ZW1zLgorCitZb3UgY2FuIGFsc28gZ3JvdXAgY29tbWFuZCBmb3JtcyB0b2dldGhl ciBpbnRvIGEgc3ViY29tbWFuZCB3aXRoIGN1cmx5CiticmFjZXMgKEBjb2Rle0B7QH19KS4g IFRoaXMgbGV0cyB5b3UgdXNlIHRoZSBvdXRwdXQgb2YgYSBzdWJjb21tYW5kIGFzCithbiBh cmd1bWVudCB0byBhbm90aGVyIGNvbW1hbmQsIG9yIHdpdGhpbiBjb250cm9sIGZsb3cgc3Rh dGVtZW50cworKEBweHJlZntDb250cm9sIEZsb3d9KS4KKworQGV4YW1wbGUKK34gJCBlY2hv IEB7ZWNobyBoZWxsbzsgZWNobyB0aGVyZUB9CitoZWxsb3RoZXJlCitAZW5kIGV4YW1wbGUK KworQHN1YnNlY3Rpb24gTGlzcCBmb3JtCitMaXNwIGZvcm0gbG9va3MgbGlrZSBvcmRpbmFy eSBFbWFjcyBMaXNwIGNvZGUsIGJlY2F1c2UgdGhhdCdzIHdoYXQgaXQKK2lzLiAgQXMgYSBy ZXN1bHQsIHlvdSBjYW4gdXNlIGFueSBzeW50YXggbm9ybWFsbHkgYXZhaWxhYmxlIHRvIGFu CitFbWFjcyBMaXNwIHByb2dyYW0gKEBweHJlZntUb3AsICwgLCBlbGlzcCwgVGhlIEVtYWNz IExpc3AgUmVmZXJlbmNlCitNYW51YWx9KS4KKworQGV4YW1wbGUKK34gJCAoZm9ybWF0ICJo ZWxsbywgJXMiIHVzZXItbG9naW4tbmFtZSkKK2hlbGxvLCB1c2VyCitAZW5kIGV4YW1wbGUK KworSW4gYWRkaXRpb24sIHlvdSBjYW4gQGVtcGh7Y29tYmluZX0gY29tbWFuZCBmb3JtcyBh bmQgTGlzcCBmb3JtcwordG9nZXRoZXIgaW50byBzaW5nbGUgc3RhdGVtZW50cywgbGV0dGlu ZyB5b3UgdXNlIHdoYXRldmVyIGZvcm0gaXMgdGhlCittb3N0IGNvbnZlbmllbnQgZm9yIGV4 cHJlc3NpbmcgeW91ciBpbnRlbnRpb25zLgorCitAZXhhbXBsZQorfiAkIGxzICoucGF0Y2gg PiAoZm9ybWF0LXRpbWUtc3RyaW5nICIlRi5sb2ciKQorQGVuZCBleGFtcGxlCisKK1RoaXMg Y29tbWFuZCB3cml0ZXMgYSBsaXN0IG9mIGFsbCBmaWxlcyBtYXRjaGluZyB0aGUgZ2xvYiBw YXR0ZXJuCitAY29kZXsqLnBhdGNofSAoQHB4cmVme0dsb2JiaW5nfSkgdG8gYSBmaWxlIG5h bWVkCitAY29kZXtAdmFye2N1cnJlbnQtZGF0ZX0ubG9nfSAoQHB4cmVme1JlZGlyZWN0aW9u fSkuCisKIEBub2RlIEFyZ3VtZW50cwogQHNlY3Rpb24gQXJndW1lbnRzCi1PcmRpbmFyaWx5 LCBjb21tYW5kIGFyZ3VtZW50cyBhcmUgcGFyc2VkIGJ5IEVzaGVsbCBhcyBlaXRoZXIgc3Ry aW5ncworT3JkaW5hcmlseSwgRXNoZWxsIHBhcnNlcyBhcmd1bWVudHMgaW4gY29tbWFuZCBm b3JtIGFzIGVpdGhlciBzdHJpbmdzCiBvciBudW1iZXJzLCBkZXBlbmRpbmcgb24gd2hhdCB0 aGUgcGFyc2VyIHRoaW5rcyB0aGV5IGxvb2sgbGlrZS4gIFRvCi1zcGVjaWZ5IGFuIGFyZ3Vt ZW50IG9mIHNvbWUgb3RoZXIgZGF0YSB0eXBlLCB5b3UgY2FuIHVzZSBhbgotQHJlZntEb2xs YXJzIEV4cGFuc2lvbiwgRWxpc3AgZXhwcmVzc2lvbn06CitzcGVjaWZ5IGFuIGFyZ3VtZW50 IG9mIHNvbWUgb3RoZXIgZGF0YSB0eXBlLCB5b3UgY2FuIHVzZSBhIExpc3AgZm9ybQorKEBw eHJlZntJbnZvY2F0aW9ufSk6CiAKIEBleGFtcGxlCiB+ICQgZWNobyAobGlzdCAxIDIgMykK QEAgLTM1NCwxMCArNDIzLDYgQEAgQnVpbHQtaW5zCiBzdWRvIGlzIGFuIGFsaWFzLCBkZWZp bmVkIGFzICIqc3VkbyAkQEAqIgogQGVuZCBleGFtcGxlCiAKLUB2aW5kZXggZXNoZWxsLXBy ZWZlci1saXNwLWZ1bmN0aW9ucwotSWYgeW91IHdvdWxkIHByZWZlciB0byB1c2UgdGhlIGJ1 aWx0LWluIGNvbW1hbmRzIGluc3RlYWQgb2YgdGhlIGV4dGVybmFsCi1jb21tYW5kcywgc2V0 IEBjb2Rle2VzaGVsbC1wcmVmZXItbGlzcC1mdW5jdGlvbnN9IHRvIEBjb2Rle3R9LgotCiBT b21lIG9mIHRoZSBidWlsdC1pbiBjb21tYW5kcyBoYXZlIGRpZmZlcmVudCBiZWhhdmlvciBm cm9tIHRoZWlyCiBleHRlcm5hbCBjb3VudGVycGFydHMsIGFuZCBzb21lIGhhdmUgbm8gZXh0 ZXJuYWwgY291bnRlcnBhcnQuICBNb3N0IG9mCiB0aGVzZSB3aWxsIHByaW50IGEgdXNhZ2Ug bWVzc2FnZSB3aGVuIGdpdmVuIHRoZSBAY29kZXstLWhlbHB9IG9wdGlvbi4KQEAgLTkyMywx NSArOTg4LDE0IEBAIEJ1aWx0LWlucwogQG5vZGUgVmFyaWFibGVzCiBAc2VjdGlvbiBWYXJp YWJsZXMKIEB2aW5kZXggZXNoZWxsLXByZWZlci1saXNwLXZhcmlhYmxlcwotU2luY2UgRXNo ZWxsIGlzIGEgY29tYmluYXRpb24gb2YgYW4gRW1hY3MgQGFjcm9ueW17UkVQTH1AZm9vdG5v dGV7Ci1TaG9ydCBmb3IgYGBSZWFkLUV2YWwtUHJpbnQgTG9vcCcnLgotfSBhbmQgYSBjb21t YW5kIHNoZWxsLCBpdCBjYW4gcmVmZXIgdG8gdmFyaWFibGVzIGZyb20gdHdvIGRpZmZlcmVu dAotc291cmNlczogb3JkaW5hcnkgRW1hY3MgTGlzcCB2YXJpYWJsZXMsIGFzIHdlbGwgYXMg ZW52aXJvbm1lbnQKLXZhcmlhYmxlcy4gIEJ5IGRlZmF1bHQsIHdoZW4gdXNpbmcgYSB2YXJp YWJsZSBpbiBFc2hlbGwsIGl0IHdpbGwgZmlyc3QKLWxvb2sgaW4gdGhlIGxpc3Qgb2YgYnVp bHQtaW4gdmFyaWFibGVzLCB0aGVuIGluIHRoZSBsaXN0IG9mCi1lbnZpcm9ubWVudCB2YXJp YWJsZXMsIGFuZCBmaW5hbGx5IGluIHRoZSBsaXN0IG9mIExpc3AgdmFyaWFibGVzLiAgSWYK LXlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIExpc3AgdmFyaWFibGVzIG92ZXIgZW52aXJvbm1l bnQgdmFyaWFibGVzLCB5b3UKLWNhbiBzZXQgQGNvZGV7ZXNoZWxsLXByZWZlci1saXNwLXZh cmlhYmxlc30gdG8gQGNvZGV7dH0uCitTaW5jZSBFc2hlbGwgaXMgYSBjb21iaW5hdGlvbiBv ZiBhbiBFbWFjcyBAYWNyb255bXtSRVBMfSBhbmQgYSBjb21tYW5kCitzaGVsbCwgaXQgY2Fu IHJlZmVyIHRvIHZhcmlhYmxlcyBmcm9tIHR3byBkaWZmZXJlbnQgc291cmNlczogb3JkaW5h cnkKK0VtYWNzIExpc3AgdmFyaWFibGVzLCBhcyB3ZWxsIGFzIGVudmlyb25tZW50IHZhcmlh Ymxlcy4gIEJ5IGRlZmF1bHQsCit3aGVuIHVzaW5nIGEgdmFyaWFibGUgaW4gRXNoZWxsLCBp dCB3aWxsIGZpcnN0IGxvb2sgaW4gdGhlIGxpc3Qgb2YKK2J1aWx0LWluIHZhcmlhYmxlcywg dGhlbiBpbiB0aGUgbGlzdCBvZiBlbnZpcm9ubWVudCB2YXJpYWJsZXMsIGFuZAorZmluYWxs eSBpbiB0aGUgbGlzdCBvZiBMaXNwIHZhcmlhYmxlcy4gIElmIHlvdSB3b3VsZCBwcmVmZXIg dG8gdXNlCitMaXNwIHZhcmlhYmxlcyBvdmVyIGVudmlyb25tZW50IHZhcmlhYmxlcywgeW91 IGNhbiBzZXQKK0Bjb2Rle2VzaGVsbC1wcmVmZXItbGlzcC12YXJpYWJsZXN9IHRvIEBjb2Rl e3R9LgogCiBZb3UgY2FuIHNldCB2YXJpYWJsZXMgaW4gYSBmZXcgZGlmZmVyZW50IHdheXMu ICBUbyBzZXQgYSBMaXNwCiB2YXJpYWJsZSwgeW91IGNhbiB1c2UgdGhlIGNvbW1hbmQgQHNh bXB7c2V0cSBAdmFye25hbWV9IEB2YXJ7dmFsdWV9fSwKLS0gCjIuMjUuMQoK --------------TiW00q0gddILaqBhLwSmfJql-- From unknown Fri Jun 13 11:34:28 2025 X-Loop: help-debbugs@gnu.org Subject: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2023 13:06:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60846 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Jim Porter Cc: 60846@debbugs.gnu.org Received: via spool by 60846-submit@debbugs.gnu.org id=B60846.167396073319112 (code B ref 60846); Tue, 17 Jan 2023 13:06:02 +0000 Received: (at 60846) by debbugs.gnu.org; 17 Jan 2023 13:05:33 +0000 Received: from localhost ([127.0.0.1]:36081 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHlef-0004yB-6c for submit@debbugs.gnu.org; Tue, 17 Jan 2023 08:05:33 -0500 Received: from eggs.gnu.org ([209.51.188.92]:51458) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHleb-0004xv-E2 for 60846@debbugs.gnu.org; Tue, 17 Jan 2023 08:05:31 -0500 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 ) id 1pHleW-0005Cr-23; Tue, 17 Jan 2023 08:05:24 -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=s9bMRAous5SNE42+QBbr23nPOnx6jTUxg/MZHBHut4w=; b=Jn67RrDc3T+O i6J0HjGur+qHNydK+QONHKo4uisO40lCTxkZab9v1XSr+sHMyO2Juv8NORsL6owpckG74WEjWCsgp ifECqaP24RdgxiObBJFPKJ1FtW7Gmkz5otnZcIh4rPb0G6FVwOpfjIMfig9dtFFQxdNnfN1qnm00I 4e5Fcm6pd3a4tVjkGSSEeznCWpFC/YR0Fv+oPdFNUWB7Kym9mxpE8/hJoeagxjeAeS3nB0AqwDDfC RSmX4dKCD7GFKl+TEnfoQn1zMgVQ4IL3l5u9g56NPOk5UJiHPIyGo9NHJTjh0INu+rNAWu9gau400 3OZh1XyKFTSy5gjYlXN4EA==; Received: from [87.69.77.57] (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 1pHleV-0000Nk-Ex; Tue, 17 Jan 2023 08:05:23 -0500 Date: Tue, 17 Jan 2023 15:05:34 +0200 Message-Id: <83tu0p2twh.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <57aba6cb-7730-cd59-cdc7-94058596f74e@gmail.com> (message from Jim Porter on Mon, 16 Jan 2023 12:18:13 -0800) References: <83wn5m4n20.fsf@gnu.org> <57aba6cb-7730-cd59-cdc7-94058596f74e@gmail.com> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Date: Mon, 16 Jan 2023 12:18:13 -0800 > Cc: 60846@debbugs.gnu.org > From: Jim Porter > > On 1/16/2023 5:38 AM, Eli Zaretskii wrote: > > Thanks. > > Thanks for the useful feedback as always. > > >> +Unlike regular system shells, Eshell never invokes kernel functions > >> +directly, such as @code{exec(3)}. Instead, it uses the Lisp functions > >> +available in the Emacs Lisp library. It does this by transforming the > >> +input line into a callable Lisp form.@footnote{To see the Lisp form > >> +that will be invoked, type: @samp{eshell-parse-command 'echo hello'}} > > > > This should use the @kbd markup, like any command the user should > > type. I also suggest to say explicitly that you mean to type this at > > the Eshell prompt, as it wasn't clear when I read it. > > Fixed. > > >> +The command can be either an Elisp function or an external command. > >> +Eshell looks for the command in the following order: > > > > Here I would add a few useful index entries > > > > @cindex order of looking for commands > > @cindex command look up, order > > Done. > > >> +@vindex eshell-prefer-lisp-functions > >> +If you would prefer to use ordinary Lisp functions over external > >> +programs, set the option @code{eshell-prefer-lisp-functions} to > >> +@code{t}. > > > > I'm guessing this swaps the order of the two last candidates, but the > > text doesn't say that explicitly for some reason. Just saying > > "prefer" is not enough when you have more than 2 candidates. > > Good point. I added an extra sentence explicitly stating that the last > two items are swapped in priority. > > >> +In addition, you can @emph{combine} command forms and Lisp forms > >> +together into single statements, letting you use whatever form is the > >> +most convenient for expressing your intentions. > >> + > >> +@example > >> +~ $ ls *.patch > (format-time-string "%F.log") > >> +@end example > > > > Either explain here the meaning of redirecting into a Lisp form, or > > add a cross-reference to where it is explained in detail. > > Done both. I've explained what the command does as well as > cross-referenced the globbing and redirection sections. > > >> +specify an argument of some other data type, you can use a > >> +@ref{Invocation, Lisp form}: > > > > This kind of cross-references is usually a bad idea in Texinfo: it > > looks nifty in HTML, but reads awkwardly in all other formats. It is > > better to use the slightly wordier alternative: > > > > specify an argument of some other data type, you can use a Lisp form > > (@pxref{Invocation}): > > Ah ha, I didn't realize. Fixed. Thanks, the patch LGTM now. From unknown Fri Jun 13 11:34:28 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Jim Porter Subject: bug#60846: closed (Re: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation) Message-ID: References: <0102dd1b-f386-bcd1-a9c7-791b36a9c61b@gmail.com> X-Gnu-PR-Message: they-closed 60846 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: patch Reply-To: 60846@debbugs.gnu.org Date: Tue, 17 Jan 2023 22:02:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1673992922-7190-1" This is a multi-part message in MIME format... ------------=_1673992922-7190-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #60846: 29.0.60; [PATCH] Add more documentation about Eshell command invoca= tion which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 60846@debbugs.gnu.org. --=20 60846: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D60846 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1673992922-7190-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 60846-done) by debbugs.gnu.org; 17 Jan 2023 22:01:39 +0000 Received: from localhost ([127.0.0.1]:38442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHu1T-0001rL-9N for submit@debbugs.gnu.org; Tue, 17 Jan 2023 17:01:39 -0500 Received: from mail-pj1-f48.google.com ([209.85.216.48]:36433) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHu1R-0001r9-4m for 60846-done@debbugs.gnu.org; Tue, 17 Jan 2023 17:01:38 -0500 Received: by mail-pj1-f48.google.com with SMTP id s13-20020a17090a6e4d00b0022900843652so311085pjm.1 for <60846-done@debbugs.gnu.org>; Tue, 17 Jan 2023 14:01:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=yke1Kbq5cKkOS+y34yNVZDuHukMdxNUzs6t+7GSwUms=; b=guN3SZFdTkh+LKROuVWzBsLn5UamwNGs3E7RrFMm+poAofRpBoFXfgNTVjNmCIzrqB 36RS7fUYl6edq5XU6VbPlFQ0wSggOjoi723329ElzHdsrMsOfkBUFj+mFmLZbqLfvtFL cU4I8prwyZfVF4loX+5/jdScOOcvabEs5yV6ZDMpx7Nl49Rh/Cb5xy1hVGXUMxEcDMDH 5eidn/D7VFtNJ98HP90g41SnxUnNc8qw1ftq//MDbYvXls4sFkIuTbrXwq0jTvX4vgOh HKz21BUiWhrYScn6AskD/cs+ulusCKE7b1CGdvZ9ThXvgD2rw5RFiExmtK6gsAziOT8p Kb/g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=yke1Kbq5cKkOS+y34yNVZDuHukMdxNUzs6t+7GSwUms=; b=q6KwqdN1mSMpD9/jRL62vF7lwXAgdW4C+nbqKV8e2Kd3r2EGuSVzpiRSIOryYY6k8o nrrGjUl11YqQQR5EzIfMtpeB56tdyqa4P8j4EXqUtOyeL84FHffHgWZennYDQoQldsaY ypKfAGhXfOrjvg846XkRXSPTEBwRoGovIv+EBmUBqkQuq8hwtiB2SKlUkM+3cdh6E9S7 UHi2CLEKFN5PVFsCQiwbaTuMB52MVWsmZZkPoIxYyBaZ5lU9kzTpy2jGziK5sESn35ee 5K+Ll+PXpbi+vkCFj/ETTCswNLF5qn3MUM4h2SrYlpqlSDWmaMR7GCOUCrsQkSG4ms1P i0Yw== X-Gm-Message-State: AFqh2ko/aLZ943isAnss2AJwn3PEwP2zOwH61cTU+Jd+7GldozT+Gj+F i2UXtySo44S3a+btVkkPZZE= X-Google-Smtp-Source: AMrXdXsCpGCZWxhjc9Tv+gLQvkvD6e8cc5J+kLkBJYzHhGOGMsIAy0jGzBFlz3lWfeRjOaTs+jjyFQ== X-Received: by 2002:a05:6a20:3c94:b0:b6:a132:7449 with SMTP id b20-20020a056a203c9400b000b6a1327449mr4689358pzj.3.1673992891097; Tue, 17 Jan 2023 14:01:31 -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 j16-20020a63ec10000000b004b1b9e23790sm15093479pgh.92.2023.01.17.14.01.30 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 17 Jan 2023 14:01:30 -0800 (PST) Message-ID: <0102dd1b-f386-bcd1-a9c7-791b36a9c61b@gmail.com> Date: Tue, 17 Jan 2023 14:01:27 -0800 MIME-Version: 1.0 Subject: Re: bug#60846: 29.0.60; [PATCH] Add more documentation about Eshell command invocation Content-Language: en-US To: Eli Zaretskii References: <83wn5m4n20.fsf@gnu.org> <57aba6cb-7730-cd59-cdc7-94058596f74e@gmail.com> <83tu0p2twh.fsf@gnu.org> From: Jim Porter In-Reply-To: <83tu0p2twh.fsf@gnu.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 60846-done Cc: 60846-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) On 1/17/2023 5:05 AM, Eli Zaretskii wrote: > Thanks, the patch LGTM now. Thanks. I merged this to the Emacs 29 branch as c4f0b6ccea. Closing this bug now. ------------=_1673992922-7190-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 16 Jan 2023 02:51:34 +0000 Received: from localhost ([127.0.0.1]:60034 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHFav-00070K-S3 for submit@debbugs.gnu.org; Sun, 15 Jan 2023 21:51:34 -0500 Received: from lists.gnu.org ([209.51.188.17]:60852) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHFat-00070C-H4 for submit@debbugs.gnu.org; Sun, 15 Jan 2023 21:51:32 -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 ) id 1pHFat-0000nx-8j for bug-gnu-emacs@gnu.org; Sun, 15 Jan 2023 21:51:31 -0500 Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pHFar-0000xY-E4 for bug-gnu-emacs@gnu.org; Sun, 15 Jan 2023 21:51:31 -0500 Received: by mail-pj1-x1030.google.com with SMTP id bj3so24550170pjb.0 for ; Sun, 15 Jan 2023 18:51:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:subject:from:content-language:mime-version:date:message-id:from :to:cc:subject:date:message-id:reply-to; bh=g+oYdQrynDiETP7i8tACrgW3ABDp81beALRhtcdK1C8=; b=X8y9XRyK8HvF55tbDmIRlNdwU/tdXGtALlC1HQ9DM8cGxD452LmFMEHyYC7Ll+g8Zx cYR3X6mYoK7bkelkIqhkaSbyqfWN90LmKDyvbSimynb9E4QoKhi8ytmoMOPw6trfxB0W z3dhhFdgbvWVIwZ/KYAW8VcLSCHrIem4K2uadb2EFF9y0524AbaSB1yiqQrTxqFqeXIS /sG8VskZBgQ2exFfSkLGuD3v1ujscUbi+0xVD/PG0/+BdSaz8dCWUzo3s0ssoIphMaxE 1Y641IPEQ0x1S4b0cns/lZZMDjPPVC8iUjNEYpGL+1iNCSUM2LKGSh+5N8egJt0TtPV4 2gjQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:subject:from:content-language:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=g+oYdQrynDiETP7i8tACrgW3ABDp81beALRhtcdK1C8=; b=4wlb8BwQRDpsBdRBoEEi+0carm6E7MVwvMh7ZrFG+Paw6BoxevvO4mXIOqGMYKK2ht IP3SEUin1+DJvg9ph/b9Uvr9L98mbBtTqvXP41AWX8fUYs5+ZfoVXRMl1hozCrGTQamH bCtCAn1XMywnNHYDyLZOiPDqpsx4/KF3RKIYy3Jj5gkPDB7DOJbrXWhXJnd/BABWGUqs TIiD1YK9H7oFYbA7UkLdiFwt06tmmR3WXDABw09iX9cym4bISApv9sP0s4tW42aSlY5G LvYq/MtStz+RpG8yygcAZyH9xyPSyvNYgL8TBQLtgqlkt5kULwhJNvWIQ0ZGc7guEkwH tw3Q== X-Gm-Message-State: AFqh2kpYBD0gTVZ1ZUCDAT/CCcRLE8InHExnhHaJHfrIdR0aCkGOTmVL Uz/nfE/Pi3dpdU8wlw4Gw+rvSrxHmAs8rw== X-Google-Smtp-Source: AMrXdXvg6UnNdWyu7V+IVNuwReyGF6XmxPOunQOiFirygHkftCNTa65rHzrlEa2vYKAKKophrfAoiA== X-Received: by 2002:a17:902:a712:b0:194:8a27:f5c6 with SMTP id w18-20020a170902a71200b001948a27f5c6mr5044412plq.22.1673837486819; Sun, 15 Jan 2023 18:51:26 -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 k7-20020a170902760700b00192bf7eaf28sm17954617pll.286.2023.01.15.18.51.24 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 15 Jan 2023 18:51:25 -0800 (PST) Content-Type: multipart/mixed; boundary="------------0aGEjTwvZlNZOElQZc5v07J2" Message-ID: Date: Sun, 15 Jan 2023 18:51:25 -0800 MIME-Version: 1.0 X-Mozilla-News-Host: news://news.gmane.io:119 Content-Language: en-US From: Jim Porter Subject: 29.0.60; [PATCH] Add more documentation about Eshell command invocation To: bug-gnu-emacs@gnu.org Received-SPF: pass client-ip=2607:f8b0:4864:20::1030; envelope-from=jporterbugs@gmail.com; helo=mail-pj1-x1030.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 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --------------0aGEjTwvZlNZOElQZc5v07J2 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit The Eshell manual isn't as thorough as it could be about how users should invoke commands. While there's a reasonable amount of documentation about the details, it never directly describes how to run a simple command. Attached is a patch to remedy this. I also corrected the documentation about how Eshell picks what command to run in command form; previously, it stated that ordinary Lisp functions had higher priority than external commands, which isn't actually the case (unless you set 'eshell-prefer-lisp-functions'). Since this is purely a documentation change, I'd like to merge this to the Emacs 29 branch. --------------0aGEjTwvZlNZOElQZc5v07J2 Content-Type: text/plain; charset=UTF-8; name="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.patch" Content-Disposition: attachment; filename*0="0001-Add-more-detail-about-how-to-invoke-Eshell-commands.pat"; filename*1="ch" Content-Transfer-Encoding: base64 RnJvbSBkMGU0Yjk0NjIzYjU4NDBhMjEyYzk3Yzc1YjE2NDFkYmJiZmY3N2VhIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgMTUgSmFuIDIwMjMgMTg6MzU6MzEgLTA4MDAKU3ViamVjdDogW1BB VENIXSBBZGQgbW9yZSBkZXRhaWwgYWJvdXQgaG93IHRvIGludm9rZSBFc2hlbGwgY29tbWFu ZHMKCiogZG9jL21pc2MvZXNoZWxsLnRleGkgKENvbW1hbmRzKTogTW92ZSBleHBsYW5hdGlv biBhYm91dCBrZXJuZWwKZnVuY3Rpb25zIHRvIGhlcmUuCihJbnZvY2F0aW9uKTogRGVzY3Jp YmUgY29tbWFuZCBmb3JtIGFuZCBMaXNwIGZvcm0uICBGaXggZG9jdW1lbnRhdGlvbgphYm91 dCBwcmlvcml0eSBvZiBjb21tYW5kcyBpbiBjb21tYW5kIGZvcm0uCi0tLQogZG9jL21pc2Mv ZXNoZWxsLnRleGkgfCA5MyArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLS0t LS0tLS0tLQogMSBmaWxlIGNoYW5nZWQsIDcwIGluc2VydGlvbnMoKyksIDIzIGRlbGV0aW9u cygtKQoKZGlmZiAtLWdpdCBhL2RvYy9taXNjL2VzaGVsbC50ZXhpIGIvZG9jL21pc2MvZXNo ZWxsLnRleGkKaW5kZXggZmM3ZDUyZWI3MTEuLmI1NDQ0NzQxYjY2IDEwMDY0NAotLS0gYS9k b2MvbWlzYy9lc2hlbGwudGV4aQorKysgYi9kb2MvbWlzYy9lc2hlbGwudGV4aQpAQCAtMTkz LDYgKzE5MywxMiBAQCBDb21tYW5kcwogY2hhcHRlciBjb3ZlcnMgY29tbWFuZCBpbnZvY2F0 aW9ucyBpbiBFc2hlbGwsIGluY2x1ZGluZyB0aGUgY29tbWFuZAogaGlzdG9yeSBhbmQgaW52 b2tpbmcgY29tbWFuZHMgaW4gYSBzY3JpcHQgZmlsZS4KIAorVW5saWtlIHJlZ3VsYXIgc3lz dGVtIHNoZWxscywgRXNoZWxsIG5ldmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucworZGly ZWN0bHksIHN1Y2ggYXMgQGNvZGV7ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBM aXNwIGZ1bmN0aW9ucworYXZhaWxhYmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJ dCBkb2VzIHRoaXMgYnkgdHJhbnNmb3JtaW5nIHRoZQoraW5wdXQgbGluZSBpbnRvIGEgY2Fs bGFibGUgTGlzcCBmb3JtLkBmb290bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybQordGhhdCB3 aWxsIGJlIGludm9rZWQsIHR5cGU6IEBzYW1we2VzaGVsbC1wYXJzZS1jb21tYW5kICdlY2hv IGhlbGxvJ319CisKIEBtZW51CiAqIEludm9jYXRpb246OgogKiBBcmd1bWVudHM6OgpAQCAt MjA3LDIzICsyMTMsMTYgQEAgQ29tbWFuZHMKIAogQG5vZGUgSW52b2NhdGlvbgogQHNlY3Rp b24gSW52b2NhdGlvbgotVW5saWtlIHJlZ3VsYXIgc3lzdGVtIHNoZWxscywgRXNoZWxsIG5l dmVyIGludm9rZXMga2VybmVsIGZ1bmN0aW9ucwotZGlyZWN0bHksIHN1Y2ggYXMgQGNvZGV7 ZXhlYygzKX0uICBJbnN0ZWFkLCBpdCB1c2VzIHRoZSBMaXNwIGZ1bmN0aW9ucwotYXZhaWxh YmxlIGluIHRoZSBFbWFjcyBMaXNwIGxpYnJhcnkuICBJdCBkb2VzIHRoaXMgYnkgdHJhbnNm b3JtaW5nIHRoZQotaW5wdXQgbGluZSBpbnRvIGEgY2FsbGFibGUgTGlzcCBmb3JtLkBmb290 bm90ZXtUbyBzZWUgdGhlIExpc3AgZm9ybSB0aGF0IHdpbGwgYmUgaW52b2tlZCwgdHlwZTog QHNhbXB7ZXNoZWxsLXBhcnNlLWNvbW1hbmQgImVjaG8gaGVsbG8ifX0KK0VzaGVsbCBpcyBi b3RoIGEgY29tbWFuZCBzaGVsbCBhbmQgYW4gRW1hY3MgTGlzcCBAYWNyb255bXtSRVBMfS4g IEFzIGEKK3Jlc3VsdCwgeW91IGNhbiBpbnZva2UgY29tbWFuZHMgaW4gdHdvIGRpZmZlcmVu dCB3YXlzOiBpbiBAZGZue2NvbW1hbmQKK2Zvcm19IG9yIGluIEBkZm57bGlzcCBmb3JtfS4K IAotVGhlIGNvbW1hbmQgY2FuIGJlIGVpdGhlciBhbiBFbGlzcCBmdW5jdGlvbiBvciBhbiBl eHRlcm5hbCBjb21tYW5kLgotRXNoZWxsIGxvb2tzIGZpcnN0IGZvciBhbiBhbGlhcyAoQHB4 cmVme0FsaWFzZXN9KSB3aXRoIHRoZSBzYW1lIG5hbWUgYXMgdGhlCi1jb21tYW5kLCB0aGVu IGEgYnVpbHQtaW4gKEBweHJlZntCdWlsdC1pbnN9KSBvciBhIGZ1bmN0aW9uIHdpdGggdGhl Ci1zYW1lIG5hbWU7IGlmIHRoZXJlIGlzIG5vIG1hdGNoLCBpdCB0aGVuIHRyaWVzIHRvIGV4 ZWN1dGUgaXQgYXMgYW4KLWV4dGVybmFsIGNvbW1hbmQuCi0KLVRoZSBzZW1pY29sb24gKEBj b2Rlezt9KSBjYW4gYmUgdXNlZCB0byBzZXBhcmF0ZSBtdWx0aXBsZSBjb21tYW5kCi1pbnZv Y2F0aW9ucyBvbiBhIHNpbmdsZSBsaW5lLiAgWW91IGNhbiBhbHNvIHNlcGFyYXRlIGNvbW1h bmRzIHdpdGgKLUBjb2RleyYmfSBvciBAY29kZXt8fH0uIFdoZW4gdXNpbmcgQGNvZGV7JiZ9 LCBFc2hlbGwgd2lsbCBleGVjdXRlIHRoZQotc2Vjb25kIGNvbW1hbmQgb25seSBpZiB0aGUg Zmlyc3Qgc3VjY2VlZHMgKGkuZS5AOiBoYXMgYW4gZXhpdAotc3RhdHVzIG9mIDApOyB3aXRo IEBjb2Rle3x8fSwgRXNoZWxsIHdpbGwgZXhlY3V0ZSB0aGUgc2Vjb25kIGNvbW1hbmQKLW9u bHkgaWYgdGhlIGZpcnN0IGZhaWxzLgorWW91IGNhbiB1c2UgdGhlIHNlbWljb2xvbiAoQGNv ZGV7O30pIHRvIHNlcGFyYXRlIG11bHRpcGxlIGNvbW1hbmQKK2ludm9jYXRpb25zIG9uIGEg c2luZ2xlIGxpbmUsIGV4ZWN1dGluZyBlYWNoIGluIHR1cm4uICBZb3UgY2FuIGFsc28KK3Nl cGFyYXRlIGNvbW1hbmRzIHdpdGggQGNvZGV7JiZ9IG9yIEBjb2Rle3x8fS4gV2hlbiB1c2lu ZyBAY29kZXsmJn0sCitFc2hlbGwgd2lsbCBleGVjdXRlIHRoZSBzZWNvbmQgY29tbWFuZCBv bmx5IGlmIHRoZSBmaXJzdCBzdWNjZWVkcworKGkuZS5AOiBoYXMgYW4gZXhpdCBzdGF0dXMg b2YgMCk7IHdpdGggQGNvZGV7fHx9LCBFc2hlbGwgd2lsbCBleGVjdXRlCit0aGUgc2Vjb25k IGNvbW1hbmQgb25seSBpZiB0aGUgZmlyc3QgZmFpbHMuCiAKIEEgY29tbWFuZCBpbnZvY2F0 aW9uIGZvbGxvd2VkIGJ5IGFuIGFtcGVyc2FuZCAoQGNvZGV7Jn0pIHdpbGwgYmUgcnVuCiBp biB0aGUgYmFja2dyb3VuZC4gIEVzaGVsbCBoYXMgbm8gam9iIGNvbnRyb2wsIHNvIHlvdSBj YW4gbm90IHN1c3BlbmQKQEAgLTIzMiwxMiArMjMxLDY0IEBAIEludm9jYXRpb24KIGNhbiBi ZSBjb250cm9sbGVkIHRoZSBzYW1lIHdheSBhcyBhbnkgb3RoZXIgYmFja2dyb3VuZCBwcm9j ZXNzIGluCiBFbWFjcy4KIAorQHN1YnNlY3Rpb24gQ29tbWFuZCBmb3JtCitDb21tYW5kIGZv cm0gbG9va3MgbXVjaCB0aGUgc2FtZSBhcyBpbiBvdGhlciBzaGVsbHMuICBBIGNvbW1hbmQK K2NvbnNpc3RzIG9mIGFyZ3VtZW50cyBzZXBhcmF0ZWQgYnkgc3BhY2VzOyB0aGUgZmlyc3Qg YXJndW1lbnQgaXMgdGhlCitjb21tYW5kIHRvIHJ1biwgd2l0aCBhbnkgc3Vic2VxdWVudCBh cmd1bWVudHMgYmVpbmcgcGFzc2VkIHRvIHRoYXQKK2NvbW1hbmQuCisKK0BleGFtcGxlCit+ ICQgZWNobyBoZWxsbworaGVsbG8KK0BlbmQgZXhhbXBsZQorCitUaGUgY29tbWFuZCBjYW4g YmUgZWl0aGVyIGFuIEVsaXNwIGZ1bmN0aW9uIG9yIGFuIGV4dGVybmFsIGNvbW1hbmQuCitF c2hlbGwgbG9va3MgZm9yIHRoZSBjb21tYW5kIGluIHRoZSBmb2xsb3dpbmcgb3JkZXI6CisK K0BlbnVtZXJhdGUKK0BpdGVtCitBcyBhIGNvbW1hbmQgYWxpYXMgKEBweHJlZntBbGlhc2Vz fSkKKworQGl0ZW0KK0FzIGEgYnVpbHQtaW4gY29tbWFuZCAoQHB4cmVme0J1aWx0LWluc30p CisKK0BpdGVtCitBcyBhbiBleHRlcm5hbCBwcm9ncmFtCisKK0BpdGVtCitBcyBhbiBvcmRp bmFyeSBMaXNwIGZ1bmN0aW9uCitAZW5kIGVudW1lcmF0ZQorCitAdmluZGV4IGVzaGVsbC1w cmVmZXItbGlzcC1mdW5jdGlvbnMKK0lmIHlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIG9yZGlu YXJ5IExpc3AgZnVuY3Rpb25zIG92ZXIgZXh0ZXJuYWwKK3Byb2dyYW1zLCBzZXQgdGhlIG9w dGlvbiBAY29kZXtlc2hlbGwtcHJlZmVyLWxpc3AtZnVuY3Rpb25zfSB0bworQGNvZGV7dH0u CisKK0BzdWJzZWN0aW9uIExpc3AgZm9ybQorTGlzcCBmb3JtIGxvb2tzIGxpa2Ugb3JkaW5h cnkgRW1hY3MgTGlzcCBjb2RlLCBiZWNhdXNlIHRoYXQncyB3aGF0IGl0Citpcy4gIEFzIGEg cmVzdWx0LCB5b3UgY2FuIHVzZSBhbnkgc3ludGF4IG5vcm1hbGx5IGF2YWlsYWJsZSB0byBh bgorRW1hY3MgTGlzcCBwcm9ncmFtIChAcHhyZWZ7VG9wLCAsICwgZWxpc3AsIFRoZSBFbWFj cyBMaXNwIFJlZmVyZW5jZQorTWFudWFsfSkuCisKK0BleGFtcGxlCit+ICQgKGZvcm1hdCAi aGVsbG8sICVzIiB1c2VyLWxvZ2luLW5hbWUpCitoZWxsbywgdXNlcgorQGVuZCBleGFtcGxl CisKK0luIGFkZGl0aW9uLCB5b3UgY2FuIEBlbXBoe2NvbWJpbmV9IGNvbW1hbmQgZm9ybXMg YW5kIExpc3AgZm9ybXMKK3RvZ2V0aGVyIGludG8gc2luZ2xlIHN0YXRlbWVudHMsIGxldHRp bmcgeW91IHVzZSB3aGF0ZXZlciBmb3JtIGlzIHRoZQorbW9zdCBjb252ZW5pZW50IGZvciBl eHByZXNzaW5nIHlvdXIgaW50ZW50aW9ucy4KKworQGV4YW1wbGUKK34gJCBscyAqLnBhdGNo ID4gKGZvcm1hdC10aW1lLXN0cmluZyAiJUYubG9nIikKK0BlbmQgZXhhbXBsZQorCiBAbm9k ZSBBcmd1bWVudHMKIEBzZWN0aW9uIEFyZ3VtZW50cwotT3JkaW5hcmlseSwgY29tbWFuZCBh cmd1bWVudHMgYXJlIHBhcnNlZCBieSBFc2hlbGwgYXMgZWl0aGVyIHN0cmluZ3MKK09yZGlu YXJpbHksIEVzaGVsbCBwYXJzZXMgYXJndW1lbnRzIGluIGNvbW1hbmQgZm9ybSBhcyBlaXRo ZXIgc3RyaW5ncwogb3IgbnVtYmVycywgZGVwZW5kaW5nIG9uIHdoYXQgdGhlIHBhcnNlciB0 aGlua3MgdGhleSBsb29rIGxpa2UuICBUbwotc3BlY2lmeSBhbiBhcmd1bWVudCBvZiBzb21l IG90aGVyIGRhdGEgdHlwZSwgeW91IGNhbiB1c2UgYW4KLUByZWZ7RG9sbGFycyBFeHBhbnNp b24sIEVsaXNwIGV4cHJlc3Npb259Ogorc3BlY2lmeSBhbiBhcmd1bWVudCBvZiBzb21lIG90 aGVyIGRhdGEgdHlwZSwgeW91IGNhbiB1c2UgYQorQHJlZntJbnZvY2F0aW9uLCBMaXNwIGZv cm19OgogCiBAZXhhbXBsZQogfiAkIGVjaG8gKGxpc3QgMSAyIDMpCkBAIC0zNTQsMTAgKzQw NSw2IEBAIEJ1aWx0LWlucwogc3VkbyBpcyBhbiBhbGlhcywgZGVmaW5lZCBhcyAiKnN1ZG8g JEBAKiIKIEBlbmQgZXhhbXBsZQogCi1AdmluZGV4IGVzaGVsbC1wcmVmZXItbGlzcC1mdW5j dGlvbnMKLUlmIHlvdSB3b3VsZCBwcmVmZXIgdG8gdXNlIHRoZSBidWlsdC1pbiBjb21tYW5k cyBpbnN0ZWFkIG9mIHRoZSBleHRlcm5hbAotY29tbWFuZHMsIHNldCBAY29kZXtlc2hlbGwt cHJlZmVyLWxpc3AtZnVuY3Rpb25zfSB0byBAY29kZXt0fS4KLQogU29tZSBvZiB0aGUgYnVp bHQtaW4gY29tbWFuZHMgaGF2ZSBkaWZmZXJlbnQgYmVoYXZpb3IgZnJvbSB0aGVpcgogZXh0 ZXJuYWwgY291bnRlcnBhcnRzLCBhbmQgc29tZSBoYXZlIG5vIGV4dGVybmFsIGNvdW50ZXJw YXJ0LiAgTW9zdCBvZgogdGhlc2Ugd2lsbCBwcmludCBhIHVzYWdlIG1lc3NhZ2Ugd2hlbiBn aXZlbiB0aGUgQGNvZGV7LS1oZWxwfSBvcHRpb24uCi0tIAoyLjI1LjEKCg== --------------0aGEjTwvZlNZOElQZc5v07J2-- ------------=_1673992922-7190-1--