From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 08 00:29:34 2024 Received: (at submit) by debbugs.gnu.org; 8 Jul 2024 04:29:34 +0000 Received: from localhost ([127.0.0.1]:49420 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sQg0L-0000lT-LM for submit@debbugs.gnu.org; Mon, 08 Jul 2024 00:29:34 -0400 Received: from lists.gnu.org ([209.51.188.17]:33056) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sQg0J-0000lL-GT for submit@debbugs.gnu.org; Mon, 08 Jul 2024 00:29:32 -0400 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 1sQg0E-0002eJ-Ji for bug-gnu-emacs@gnu.org; Mon, 08 Jul 2024 00:29:26 -0400 Received: from mail-pg1-x531.google.com ([2607:f8b0:4864:20::531]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sQg0C-0002HA-KQ for bug-gnu-emacs@gnu.org; Mon, 08 Jul 2024 00:29:26 -0400 Received: by mail-pg1-x531.google.com with SMTP id 41be03b00d2f7-7163489149eso2526273a12.1 for ; Sun, 07 Jul 2024 21:29:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720412963; x=1721017763; darn=gnu.org; h=subject:from:to:content-language:mime-version:date:message-id:from :to:cc:subject:date:message-id:reply-to; bh=/dOFxfu6Sh+t/v8Cq3S6EY6Zz65weiMTP1eIw36NWXU=; b=dQgH0XpbLKCtcdrIwOBwiaTB19UiH9wnXb3vwnF4vFjd12hXGh6sOh7TTXM+te3BUg Q19PqrOdsCOAc9bnalXAfW+IfybeszxsQnzzTM7KMhD4ozmguUBygY/DNB9WdulX1/82 d8X5rwdZ+H/ZmJl8XxD9fipctg8om8goReDoUTWiHY3VAdFvsalojjqg3FQ0fzDnZ+Ew 3nX4qDI5Tb77jHPSFQV46bDYubAAtvZQ+LF9a2/aSXRGIGaAAeA/FeVxyC4xEO4uO/mp h07q8FVk65jz810hP1VYLXPuwGC9EC8WAp2oSvSq62hbmnah6NeKj/vmPfW7ObXF2CGU aXqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720412963; x=1721017763; h=subject:from:to:content-language:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=/dOFxfu6Sh+t/v8Cq3S6EY6Zz65weiMTP1eIw36NWXU=; b=DaZ4GHCBvBQ2sFn5xWd05ertQ+wUXssltyNH2+63fJm1bblyBZyFpbQ3C10pBFFEoh 3AbumWEsMTVv1DfH1E9Akv1GRpx/e5pG6LT5sdBedkvpxB/p8K9lNvwkhV4f/c5lxZPi CEERHRLrnhyER6DNfzfOz5RlK18mpk1NDAE6oCJkQpexQK8wzM93WFY52gHivhg3b1ow ERdneJZgi4IUMiC6zMJ2rpsrvFcTvdodBa7zuKmEKmSlA8SlvrSWJlXxdvLDE0ajRWxm Y87ZgcLOBS+YBX0Ciai42thwHqEvQlONdehOWcdYb6e/UcK0C/Bn28DakwMWPfjUf6Gr klxQ== X-Gm-Message-State: AOJu0YxJIGmjS3MbllIakc9hqtpToYPcwKZlZEv3YTXRUq7VQRveKMTb /09gm/nkbXGL6cE9AcVm4FuWAXydxF9hXSrNrDeIT9z5Blk2Ri3RGRrAGA== X-Google-Smtp-Source: AGHT+IHTylF9AUFToO81eqsgH0jCl9QLvnKNynyVsDTC4MVFLgLTmOYgtc65uWRtdS4P+aXUAEW8oA== X-Received: by 2002:a05:6a21:6da0:b0:1bd:2c36:afd6 with SMTP id adf61e73a8af0-1c0cc75488fmr15149862637.2.1720412962575; Sun, 07 Jul 2024 21:29:22 -0700 (PDT) Received: from [192.168.1.2] (syn-023-240-098-037.res.spectrum.com. [23.240.98.37]) by smtp.googlemail.com with ESMTPSA id d9443c01a7336-1fb97406eb9sm8346085ad.208.2024.07.07.21.29.21 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 07 Jul 2024 21:29:21 -0700 (PDT) Content-Type: multipart/mixed; boundary="------------z6xM7GlcGCdATHriGul5AWnV" Message-ID: Date: Sun, 7 Jul 2024 21:29:22 -0700 MIME-Version: 1.0 X-Mozilla-News-Host: news://news.gmane.io:119 Content-Language: en-US To: bug-gnu-emacs@gnu.org From: Jim Porter Subject: 30.0.60; [PATCH] Document Eshell entry points Received-SPF: pass client-ip=2607:f8b0:4864:20::531; envelope-from=jporterbugs@gmail.com; helo=mail-pg1-x531.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. --------------z6xM7GlcGCdATHriGul5AWnV Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Recently, I noticed a fairly important thing missing from the Eshell manual: it never actually tells users how to *start* Eshell! As there are several ways, I think it would be useful to describe all of them. Patch attached (intended for Emacs 30). --------------z6xM7GlcGCdATHriGul5AWnV Content-Type: text/plain; charset=UTF-8; name="0001-Document-Eshell-entry-points.patch" Content-Disposition: attachment; filename="0001-Document-Eshell-entry-points.patch" Content-Transfer-Encoding: base64 RnJvbSBhYmM0ZWFmYTE3OWE1YTI1OGEwZjJhYzJlZjY4M2I1OWIzZDQ1MWIyIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgNyBKdWwgMjAyNCAyMToyNDo0NyAtMDcwMApTdWJqZWN0OiBbUEFU Q0hdIERvY3VtZW50IEVzaGVsbCBlbnRyeSBwb2ludHMKCiogZG9jL21pc2MvZXNoZWxsLnRl eGkgKEVudHJ5IFBvaW50cyk6IE5ldyBjaGFwdGVyLgooU2NyaXB0cyk6IE1vdmUgdW5kZXIg RW50cnkgUG9pbnRzLiAgRXhwYW5kIGRvY3VtZW50YXRpb24uCi0tLQogZG9jL21pc2MvZXNo ZWxsLnRleGkgfCAxMzEgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0tLS0t LS0tLQogMSBmaWxlIGNoYW5nZWQsIDEwMyBpbnNlcnRpb25zKCspLCAyOCBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2MvbWlzYy9lc2hlbGwudGV4aSBiL2RvYy9taXNjL2VzaGVs bC50ZXhpCmluZGV4IDY5Zjk0ZmFiNDY5Li4yMTIyNTNiYWJlNiAxMDA2NDQKLS0tIGEvZG9j L21pc2MvZXNoZWxsLnRleGkKKysrIGIvZG9jL21pc2MvZXNoZWxsLnRleGkKQEAgLTc2LDYg Kzc2LDcgQEAgVG9wCiAKIEBtZW51CiAqIEludHJvZHVjdGlvbjo6ICAgICAgICAgICAgIEEg YnJpZWYgaW50cm9kdWN0aW9uIHRvIHRoZSBFbWFjcyBTaGVsbC4KKyogRW50cnkgUG9pbnRz OjoKICogQ29tbWFuZHM6OgogKiBFeHBhbnNpb246OgogKiBJbnB1dC9PdXRwdXQ6OgpAQCAt MTg2LDYgKzE4NywxMDggQEAgQ29udHJpYnV0b3JzIHRvIEVzaGVsbAogcmVxdWVzdHMsIGJ1 ZyByZXBvcnRzIGFuZCBlbmNvdXJhZ2VtZW50LiAgVGhhbmtzIGEgbG90ISAgV2l0aG91dCB5 b3UKIHRoZXJlIHdvdWxkIGJlIG5vIG5ldyByZWxlYXNlcyBvZiBFc2hlbGwuCiAKK0Bub2Rl IEVudHJ5IFBvaW50cworQGNoYXB0ZXIgRW50cnkgUG9pbnRzCisKK0VzaGVsbCBwcm92aWRl cyBzZXZlcmFsIGRpZmZlcmVudCB3YXlzIHRvIHN0YXJ0IGl0LCBkZXBlbmRpbmcgb24gdGhl CitzaXR1YXRpb24uCisKK0BtZW51CisqIEludGVyYWN0aXZlIFNoZWxsOjoKKyogT25lLU9m ZiBDb21tYW5kczo6CisqIFNjcmlwdHM6OgorQGVuZCBtZW51CisKK0Bub2RlIEludGVyYWN0 aXZlIFNoZWxsCitAc2VjdGlvbiBJbnRlcmFjdGl2ZSBTaGVsbAorCitUaGUgbW9zdCBjb21t b24gd2F5IHRvIHVzZSBFc2hlbGwgaXMgdmlhIGFuIGludGVyYWN0aXZlIHNoZWxsLiAgWW91 IGNhbgorc3RhcnQgdGhpcyB2aWEgdGhlIEBjb2Rle2VzaGVsbH0gY29tbWFuZDoKKworQGRl ZmZuIENvbW1hbmQgZXNoZWxsICZvcHRpb25hbCBhcmcKK1N0YXJ0IGEgbmV3IGludGVyYWN0 aXZlIEVzaGVsbCBzZXNzaW9uLCBvciBzd2l0Y2ggdG8gYW4gYWxyZWFkeSBhY3RpdmUKK3Nl c3Npb24uICBUaGUgZXhhY3QgYmVoYXZpb3IgZGVwZW5kcyBvbiB0aGUgdmFsdWUgb2YgQHZh cnthcmd9CisoaW50ZXJhY3RpdmVseSwgdGhlIHByZWZpeCBhcmd1bWVudCk6CisKK0B0YWJs ZSBAYXNpcworCitAaXRlbSBAY29kZXtuaWx9CitTdGFydCBvciBzd2l0Y2ggdG8gdGhlIGRl ZmF1bHQgRXNoZWxsIHNlc3Npb24uCisKK0BpdGVtIGEgbnVtYmVyCitTdGFydCBvciBzd2l0 Y2ggdG8gdGhlIEVzaGVsbCBzZXNzaW9uIHdpdGggdGhlIHNwZWNpZmllZCBudW1iZXIgKGUu Zy5AOgorQHNhbXB7KmVzaGVsbCo8Mj59KS4KKworQGl0ZW0gYW55dGhpbmcgZWxzZQorU3Rh cnQgYSBuZXcgRXNoZWxsIHNlc3Npb24sIG5vIG1hdHRlciBpZiBhbm90aGVyIG9uZSBhbHJl YWR5IGV4aXN0cy4KKworQGVuZCB0YWJsZQorQGVuZCBkZWZmbgorCitAbm9kZSBPbmUtT2Zm IENvbW1hbmRzCitAc2VjdGlvbiBPbmUtT2ZmIENvbW1hbmRzCisKK1lvdSBjYW4gYWxzbyBy dW4gaW5kaXZpZHVhbCBFc2hlbGwgY29tbWFuZHMgZnJvbSBhbnl3aGVyZSB3aXRoaW4gRW1h Y3M6CisKK0BkZWZmbiBDb21tYW5kIGVzaGVsbC1jb21tYW5kIGNvbW1hbmQgJm9wdGlvbmFs IHRvLWN1cnJlbnQtYnVmZmVyCitFeGVjdXRlIHRoZSBFc2hlbGwgY29tbWFuZCBzdHJpbmcg QHZhcntjb21tYW5kfSBhbmQgc2hvdyB0aGUgb3V0cHV0IGluIGEKK2J1ZmZlci4gIElmIEB2 YXJ7dG8tY3VycmVudC1idWZmZXJ9IGlzIG5vbi1AY29kZXtuaWx9IChpbnRlcmFjdGl2ZWx5 LAord2l0aCB0aGUgcHJlZml4IGFyZ3VtZW50KSwgdGhlbiBpbnNlcnQgb3V0cHV0IGludG8g dGhlIGN1cnJlbnQgYnVmZmVyIGF0Citwb2ludC4KKworV2hlbiB0aGUgY29tbWFuZCBlbmRz IHdpdGggQGtiZHsmfSwgRXNoZWxsIHdpbGwgZXZhbHVhdGUgdGhlIGNvbW1hbmQKK2FzeW5j aHJvbm91c2x5LiAgT3RoZXJ3aXNlLCBpdCB3aWxsIHdhaXQgdW50aWwgdGhlIGNvbW1hbmQg aGFzIGZpbmlzaGVkCitleGVjdXRpb24uCitAZW5kIGRlZmZuCisKK0BkZWZ1biBlc2hlbGwt Y29tbWFuZC1yZXN1bHQgY29tbWFuZCAmb3B0aW9uYWwgc3RhdHVzLXZhcgorRXhlY3V0ZSB0 aGUgRXNoZWxsIGNvbW1hbmQgc3RyaW5nIEB2YXJ7Y29tbWFuZH0gYW5kIHJldHVybiB0aGUg cmVzdWx0LAorbGlrZSB1c2luZyB0aGUgdmFyaWFibGUgQGNvZGV7JCR9IGluIGFuIGludGVy YWN0aXZlIHNlc3Npb24KKyhAcHhyZWZ7VmFyaWFibGVzfSkuICBJZiBAdmFye3N0YXR1cy12 YXJ9IGlzIGEgc3ltYm9sLCB0aGlzIGZ1bmN0aW9uCit3aWxsIHNldCBpdCB0byB0aGUgZXhp dCBzdGF0dXMgb2YgdGhlIGNvbW1hbmQgKGxpa2UgdXNpbmcgdGhlIHZhcmlhYmxlCitAY29k ZXskP30gaW4gYW4gaW50ZXJhY3RpdmUgc2Vzc2lvbikuCitAZW5kIGRlZnVuCisKK0Bub2Rl IFNjcmlwdHMKK0BzZWN0aW9uIFNjcmlwdHMKK0BjbWluZGV4IHNvdXJjZQorQGNtaW5kZXgg LgorTGlrZSBvdGhlciBzaGVsbHMsIHlvdSBjYW4gY3JlYXRlIEVzaGVsbCBAZGZue3Njcmlw dHN9LiAgQW4gRXNoZWxsCitzY3JpcHQgaXMgc2ltcGx5IGEgZmlsZSBjb250YWluaW5nIGEg c2VxdWVuY2Ugb2YgY29tbWFuZHMgdGhhdCB3aWxsIGJlCitleGVjdXRlZCBhcyB0aG91Z2gg eW91IGVudGVyZWQgdGhlbSBvbmUgYXQgYSB0aW1lIGluIGFuIGludGVyYWN0aXZlCitFc2hl bGwgc2Vzc2lvbi4gIFlvdSBjYW4gaW52b2tlIHRoZXNlIHNjcmlwdHMgZnJvbSB3aXRoaW4g RXNoZWxsIHdpdGgKK0Bjb21tYW5ke3NvdXJjZX0sIHdoaWNoIHdpbGwgcnVuIHRoZSBzY3Jp cHQgaW4gYSBzdWJzaGVsbC4gIElmIHlvdSB3aXNoCit0byBydW4gYSBzY3JpcHQgaW4geW91 ciBAZW1waHtjdXJyZW50fSBFc2hlbGwgZW52aXJvbm1lbnQsIHVzZSB0aGUKK0Bjb2Rley59 IGNvbW1hbmQgaW5zdGVhZC4KKworTGlrZSB3aXRoIGFsaWFzZXMgKEBweHJlZntBbGlhc2Vz fSksIEVzaGVsbCBzY3JpcHRzIGNhbiBhY2NlcHQgYW55CitudW1iZXIgb2YgYXJndW1lbnRz LiAgV2l0aGluIHRoZSBzY3JpcHQsIHlvdSBjYW4gcmVmZXIgdG8gdGhlc2Ugd2l0aAordGhl IHNwZWNpYWwgdmFyaWFibGVzIEBjb2RleyQwfSwgQGNvZGV7JDF9LCBAZG90c3t9LCBAY29k ZXskOX0sIGFuZAorQGNvZGV7JCp9LgorCitZb3UgY2FuIGFsc28gaW52b2tlIEVzaGVsbCBz Y3JpcHRzIGZyb20gb3V0c2lkZSBvZiBFc2hlbGw6CisKK0BkZWZ1biBlc2hlbGwtZXhlY3V0 ZS1maWxlIGZpbGUgJm9wdGlvbmFsIGFyZ3MgZGVzdGluYXRpb24KK0V4ZWN1dGUgdGhlIEVz aGVsbCBjb21tYW5kcyBjb250YWluZWQgaW4gQHZhcntmaWxlfSwgcGFzc2luZyBhbiBvcHRp b25hbAorbGlzdCBvZiBAdmFye2FyZ3N9IHRvIHRoZSBzY3JpcHQuICBJZiBAdmFye2Rlc3Rp bmF0aW9ufSBpcyBAY29kZXt0fSwKK3dyaXRlIHRoZSBjb21tYW5kIG91dHB1dCB0byB0aGUg Y3VycmVudCBidWZmZXIuICBJZiBAY29kZXtuaWx9LCBkb24ndAord3JpdGUgdGhlIG91dHB1 dCBhbnl3aGVyZS4gIEZvciBhbnkgb3RoZXIgdmFsdWUsIG91dHB1dCB0byB0aGUKK2NvcnJl c3BvbmRpbmcgRXNoZWxsIHRhcmdldCAoQHB4cmVme1JlZGlyZWN0aW9ufSkuCitAZW5kIGRl ZnVuCisKK0BkZWZ1biBlc2hlbGwtYmF0Y2gtZmlsZQorVGhpcyBmdW5jdGlvbiBsZXRzIHlv dSBtYWtlIGFuIEVzaGVsbCBzY3JpcHQgZmlsZSBleGVjdXRhYmxlIGZyb20KK291dHNpZGUg b2YgRW1hY3MgYnkgYWRkaW5nIGl0IHRvIHRoZSBzY3JpcHQncyBpbnRlcnByZXRlciBkaXJl Y3RpdmUgbGlrZQordGhpczoKKworQGV4YW1wbGUKKyMhL3Vzci9iaW4vZW52IC1TIGVtYWNz IC0tYmF0Y2ggLWYgZXNoZWxsLWJhdGNoLWZpbGUKK0BlbmQgZXhhbXBsZQorCitBcyB3aXRo IG90aGVyIHdheXMgb2YgaW52b2tpbmcgRXNoZWxsIHNjcmlwdHMsIHlvdSBjYW4gcGFzcyBl eHRyYQorYXJndW1lbnRzIHRvIHRoZSBzY3JpcHQgb24gdGhlIGNvbW1hbmQgbGluZS4KK0Bl bmQgZGVmdW4KKwogQG5vZGUgQ29tbWFuZHMKIEBjaGFwdGVyIENvbW1hbmRzCiAKQEAgLTIw OCw3ICszMTEsNiBAQCBDb21tYW5kcwogKiBBbGlhc2VzOjoKICogUmVtb3RlIEFjY2Vzczo6 CiAqIENvbnRyb2wgRmxvdzo6Ci0qIFNjcmlwdHM6OgogQGVuZCBtZW51CiAKIEBub2RlIElu dm9jYXRpb24KQEAgLTE1OTQsMzMgKzE2OTYsNiBAQCBDb250cm9sIEZsb3cKIAogQGVuZCB0 YWJsZQogCi1Abm9kZSBTY3JpcHRzCi1Ac2VjdGlvbiBTY3JpcHRzCi1AY21pbmRleCBzb3Vy Y2UKLUBmbmluZGV4IGVzaGVsbC1leGVjdXRlLWZpbGUKLUBmbmluZGV4IGVzaGVsbC1iYXRj aC1maWxlCi1Zb3UgY2FuIHJ1biBFc2hlbGwgc2NyaXB0cyBtdWNoIGxpa2Ugc2NyaXB0cyBm b3Igb3RoZXIgc2hlbGxzOyB0aGUgbWFpbgotZGlmZmVyZW5jZSBpcyB0aGF0IHNpbmNlIEVz aGVsbCBpcyBub3QgYSBzeXN0ZW0gY29tbWFuZCwgeW91IGhhdmUgdG8gcnVuCi1pdCBmcm9t IHdpdGhpbiBFbWFjcy4gIEFuIEVzaGVsbCBzY3JpcHQgaXMgc2ltcGx5IGEgZmlsZSBjb250 YWluaW5nIGEKLXNlcXVlbmNlIG9mIGNvbW1hbmRzLCBhcyB3aXRoIGFsbW9zdCBhbnkgb3Ro ZXIgc2hlbGwgc2NyaXB0LiAgWW91IGNhbgotaW52b2tlIHNjcmlwdHMgZnJvbSB3aXRoaW4g RXNoZWxsIHdpdGggQGNvbW1hbmR7c291cmNlfSwgb3IgZnJvbQotYW55d2hlcmUgaW4gRW1h Y3Mgd2l0aCBAY29kZXtlc2hlbGwtZXhlY3V0ZS1maWxlfS4gIEFkZGl0aW9uYWxseSwgeW91 Ci1jYW4gbWFrZSBhbiBFc2hlbGwgc2NyaXB0IGZpbGUgZXhlY3V0YWJsZSBieSBjYWxsaW5n Ci1AY29kZXtlc2hlbGwtYmF0Y2gtZmlsZX0gaW4gdGhlIGludGVycHJldGVyIGRpcmVjdGl2 ZToKLQotQGV4YW1wbGUKLSMhL3Vzci9iaW4vZW52IC1TIGVtYWNzIC0tYmF0Y2ggLWYgZXNo ZWxsLWJhdGNoLWZpbGUKLUBlbmQgZXhhbXBsZQotCi1MaWtlIHdpdGggYWxpYXNlcyAoQHB4 cmVme0FsaWFzZXN9KSwgRXNoZWxsIHNjcmlwdHMgY2FuIGFjY2VwdCBhbnkKLW51bWJlciBv ZiBhcmd1bWVudHMuICBXaXRoaW4gdGhlIHNjcmlwdCwgeW91IGNhbiByZWZlciB0byB0aGVz ZSB3aXRoCi10aGUgc3BlY2lhbCB2YXJpYWJsZXMgQGNvZGV7JDB9LCBAY29kZXskMX0sIEBk b3Rze30sIEBjb2RleyQ5fSwgYW5kCi1AY29kZXskKn0uCi0KLUBjbWluZGV4IC4KLUlmIHlv dSB3aXNoIHRvIGxvYWQgYSBzY3JpcHQgaW50byB5b3VyIEBlbXBoe2N1cnJlbnR9IGVudmly b25tZW50LAotcmF0aGVyIHRoYW4gaW4gYSBzdWJzaGVsbCwgdXNlIHRoZSBAY29kZXsufSBj b21tYW5kLgotCiBAbm9kZSBFeHBhbnNpb24KIEBjaGFwdGVyIEV4cGFuc2lvbgogRXhwYW5z aW9uIGluIGEgY29tbWFuZCBzaGVsbCBpcyBzb21ld2hhdCBsaWtlIG1hY3JvIGV4cGFuc2lv biBpbiBtYWNybwotLSAKMi4yNS4xCgo= --------------z6xM7GlcGCdATHriGul5AWnV-- From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 08 07:16:29 2024 Received: (at 71987) by debbugs.gnu.org; 8 Jul 2024 11:16:30 +0000 Received: from localhost ([127.0.0.1]:49814 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sQmM9-0005z2-Jm for submit@debbugs.gnu.org; Mon, 08 Jul 2024 07:16:29 -0400 Received: from eggs.gnu.org ([209.51.188.92]:45902) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sQmM7-0005yp-7S for 71987@debbugs.gnu.org; Mon, 08 Jul 2024 07:16:27 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sQmLx-00034G-39; Mon, 08 Jul 2024 07:16:17 -0400 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=XVs6iUNxYG06kO3FQ31Et23yXSUDeiOiuW7djGzRJlc=; b=iBrflnsinZB7 98plddHfDtszCwz6OLiRKDfKtWCVxYy+g4uAZdX24e2nu2YwUL6DV9+oSEQSbnqm6lmBgeN3alv2c 2GlojX359BtEuNPcG53Ksn+0RlaUpmYIensQi63/8FKs5Xf+1BXweRW1JHaPGuOx008a8JXXqkjdv XOoR4o5Q+cTtS3Ge/aZSVfn++n0FYWMj0a4N1S/fguzj0ICiVnkwzzA4vsUUBeYwjcVu8FB3vGpz9 6IFYB7AV0a+iTqYXrtUqH8FF5MRceRNrXO9UE5PhzmQEDosYd1pjL03faV5VZ2ilcvnadkECp9osJ 6baQxQ0t3NeRtmnMGm0Xmw==; Date: Mon, 08 Jul 2024 14:16:12 +0300 Message-Id: <86a5is16df.fsf@gnu.org> From: Eli Zaretskii To: Jim Porter In-Reply-To: (message from Jim Porter on Sun, 7 Jul 2024 21:29:22 -0700) Subject: Re: bug#71987: 30.0.60; [PATCH] Document Eshell entry points References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71987 Cc: 71987@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: -3.3 (---) > Date: Sun, 7 Jul 2024 21:29:22 -0700 > From: Jim Porter > > Recently, I noticed a fairly important thing missing from the Eshell > manual: it never actually tells users how to *start* Eshell! Ouch! > As there are several ways, I think it would be useful to describe > all of them. Patch attached (intended for Emacs 30). This is fine for emacs-30, thanks. > +@deffn Command eshell &optional arg > +Start a new interactive Eshell session, or switch to an already active > +session. The exact behavior depends on the value of @var{arg} > +(interactively, the prefix argument): > + > +@table @asis > + > +@item @code{nil} > +Start or switch to the default Eshell session. This should tell that this is what happens if the user types just @kbd{M-x eshell @key{RET}}. I'd probably also say "@code{nil} or omitted". Please also think about adding more indexing for these sections. From debbugs-submit-bounces@debbugs.gnu.org Mon Jul 08 23:48:18 2024 Received: (at 71987) by debbugs.gnu.org; 9 Jul 2024 03:48:18 +0000 Received: from localhost ([127.0.0.1]:51842 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sR1px-0004d6-Mb for submit@debbugs.gnu.org; Mon, 08 Jul 2024 23:48:18 -0400 Received: from mail-oo1-f41.google.com ([209.85.161.41]:44139) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sR1pt-0004cm-FD for 71987@debbugs.gnu.org; Mon, 08 Jul 2024 23:48:16 -0400 Received: by mail-oo1-f41.google.com with SMTP id 006d021491bc7-5b53bb4bebaso2658592eaf.0 for <71987@debbugs.gnu.org>; Mon, 08 Jul 2024 20:48:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720496822; x=1721101622; darn=debbugs.gnu.org; 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=NKyJMC/UDfBEUJ5ELxNj1jTY68RtUAFoIGQn+zgGEAc=; b=iTJvuFmtuT7TE4yrEOOANZRhZZjwQjzIkRmLo04ZfStGroZA3oyT0zXWh+V5Y4ZDeZ SCNBLnzTLlICmqvpryw+cg5NvsMrZLhpqSp62xmY7oYTeI/itxd2jT/UL7HoetzKbu2y l8aTl4zrGB7/gYguV2JeEk3Yk9lfIq+651O6TcX2Amt41kuOi631vyrEkM1kXP3E1UD9 qXwDkvBB0yi8J0K/E1WorAVC79UaFCPQhquH4KnSffQROgSKWiUimxci1qkNrvFy5zrK mk1H7MaYo+W7BhlTCWxeaW795+c6LbJKCPq9ghXU8mDkyudVHD9dHW5BepZVGzAGg1I3 MNYQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720496822; x=1721101622; 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=NKyJMC/UDfBEUJ5ELxNj1jTY68RtUAFoIGQn+zgGEAc=; b=UkpjydpSfsyYhgvqJNzrpSC0Ai52cM+/IWmZkT9+fRoYcTrpD1fRu8I6sY/W7sP7/e qDF1zT9ZhDsZIBVp+s9LAoRbbxZWOUJ1wpczVF30sOLOMP//NatBZLhlEzFY7vTJ/LQl xUGJJn9LgB/5A963gHxg7pYFcPe2tg7SJktT3AvHXE2PFCP5SE1OUdlmIXyvYL9BtWq6 /32c/Jg0wX+5hEz49bPzwsPzJSV+Ep0os8UE6O/61J4wQM/hBnQIUYVdzdVM5H5cQNey zZNTvp7Bu3WJr0CcM6qdPOC9d1pjmjNXtQwo+b8nJkIxUq7Ms3l92zwJp1ecFhr4Chbw b3ow== X-Gm-Message-State: AOJu0Yykc74trMsqt2NjszoBO6wW3/UXHiJvUYkwUl8DEYI4WNWeL7Pu q6wZiwRM7gyBPuYbmKZVC2v+Xv2E7zuRM5zlknusLkCJp5U5pK4v X-Google-Smtp-Source: AGHT+IFLJH3/cuNJvjUpfdz6qFQ7SzW5aKkhWpNJUkRnatj80scbPzyXLbsOiTuzJ0EIo2whU0J/rQ== X-Received: by 2002:a05:6358:1a:b0:1aa:d3b7:765c with SMTP id e5c5f4694b2df-1aade28130dmr109670955d.14.1720496821377; Mon, 08 Jul 2024 20:47:01 -0700 (PDT) Received: from [192.168.1.2] (syn-023-240-098-037.res.spectrum.com. [23.240.98.37]) by smtp.googlemail.com with ESMTPSA id d9443c01a7336-1fbb6aceb58sm5889945ad.254.2024.07.08.20.47.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 08 Jul 2024 20:47:00 -0700 (PDT) Content-Type: multipart/mixed; boundary="------------FGd60y3iY0cv3aS5CZgKW0bI" Message-ID: Date: Mon, 8 Jul 2024 20:47:00 -0700 MIME-Version: 1.0 Subject: Re: bug#71987: 30.0.60; [PATCH] Document Eshell entry points Content-Language: en-US To: Eli Zaretskii References: <86a5is16df.fsf@gnu.org> From: Jim Porter In-Reply-To: <86a5is16df.fsf@gnu.org> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 71987 Cc: 71987@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 (-) This is a multi-part message in MIME format. --------------FGd60y3iY0cv3aS5CZgKW0bI Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 7/8/2024 4:16 AM, Eli Zaretskii wrote: > This should tell that this is what happens if the user types just > @kbd{M-x eshell @key{RET}}. I'd probably also say "@code{nil} or > omitted". > > Please also think about adding more indexing for these sections. Done both of these (see attached). --------------FGd60y3iY0cv3aS5CZgKW0bI Content-Type: text/plain; charset=UTF-8; name="0001-Document-Eshell-entry-points.patch" Content-Disposition: attachment; filename="0001-Document-Eshell-entry-points.patch" Content-Transfer-Encoding: base64 RnJvbSA5MDkyZDVmZGQyMzU4MjkyZTFhNjgwNDRmZjU3ZDIyYWVjNTMwNDg2IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBKaW0gUG9ydGVyIDxqcG9ydGVyYnVnc0BnbWFpbC5j b20+CkRhdGU6IFN1biwgNyBKdWwgMjAyNCAyMToyNDo0NyAtMDcwMApTdWJqZWN0OiBbUEFU Q0hdIERvY3VtZW50IEVzaGVsbCBlbnRyeSBwb2ludHMKCiogZG9jL21pc2MvZXNoZWxsLnRl eGkgKEVudHJ5IFBvaW50cyk6IE5ldyBjaGFwdGVyLgooU2NyaXB0cyk6IE1vdmUgdW5kZXIg RW50cnkgUG9pbnRzLiAgRXhwYW5kIGRvY3VtZW50YXRpb24uCi0tLQogZG9jL21pc2MvZXNo ZWxsLnRleGkgfCAxMzkgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0tLS0t LS0tLQogMSBmaWxlIGNoYW5nZWQsIDExMSBpbnNlcnRpb25zKCspLCAyOCBkZWxldGlvbnMo LSkKCmRpZmYgLS1naXQgYS9kb2MvbWlzYy9lc2hlbGwudGV4aSBiL2RvYy9taXNjL2VzaGVs bC50ZXhpCmluZGV4IDY5Zjk0ZmFiNDY5Li40NWJiMWY4MDZlZSAxMDA2NDQKLS0tIGEvZG9j L21pc2MvZXNoZWxsLnRleGkKKysrIGIvZG9jL21pc2MvZXNoZWxsLnRleGkKQEAgLTc2LDYg Kzc2LDcgQEAgVG9wCiAKIEBtZW51CiAqIEludHJvZHVjdGlvbjo6ICAgICAgICAgICAgIEEg YnJpZWYgaW50cm9kdWN0aW9uIHRvIHRoZSBFbWFjcyBTaGVsbC4KKyogRW50cnkgUG9pbnRz OjoKICogQ29tbWFuZHM6OgogKiBFeHBhbnNpb246OgogKiBJbnB1dC9PdXRwdXQ6OgpAQCAt MTg2LDYgKzE4NywxMTYgQEAgQ29udHJpYnV0b3JzIHRvIEVzaGVsbAogcmVxdWVzdHMsIGJ1 ZyByZXBvcnRzIGFuZCBlbmNvdXJhZ2VtZW50LiAgVGhhbmtzIGEgbG90ISAgV2l0aG91dCB5 b3UKIHRoZXJlIHdvdWxkIGJlIG5vIG5ldyByZWxlYXNlcyBvZiBFc2hlbGwuCiAKK0Bub2Rl IEVudHJ5IFBvaW50cworQGNoYXB0ZXIgRW50cnkgUG9pbnRzCitAY2luZGV4IHN0YXJ0aW5n IEVzaGVsbAorQGNpbmRleCBFc2hlbGwsIHN0YXJ0aW5nCisKK0VzaGVsbCBwcm92aWRlcyBz ZXZlcmFsIGRpZmZlcmVudCB3YXlzIHRvIHN0YXJ0IGl0LCBkZXBlbmRpbmcgb24gdGhlCitz aXR1YXRpb24uCisKK0BtZW51CisqIEludGVyYWN0aXZlIFNoZWxsOjoKKyogT25lLU9mZiBD b21tYW5kczo6CisqIFNjcmlwdHM6OgorQGVuZCBtZW51CisKK0Bub2RlIEludGVyYWN0aXZl IFNoZWxsCitAc2VjdGlvbiBJbnRlcmFjdGl2ZSBTaGVsbAorQGNpbmRleCBpbnRlcmFjdGl2 ZSBzZXNzaW9uCisKK1RoZSBtb3N0IGNvbW1vbiB3YXkgdG8gdXNlIEVzaGVsbCBpcyB2aWEg YW4gaW50ZXJhY3RpdmUgc2hlbGwuICBZb3UgY2FuCitzdGFydCB0aGlzIHZpYSB0aGUgQGNv ZGV7ZXNoZWxsfSBjb21tYW5kOgorCitAZGVmZm4gQ29tbWFuZCBlc2hlbGwgJm9wdGlvbmFs IGFyZworU3RhcnQgYSBuZXcgaW50ZXJhY3RpdmUgRXNoZWxsIHNlc3Npb24sIG9yIHN3aXRj aCB0byBhbiBhbHJlYWR5IGFjdGl2ZQorc2Vzc2lvbi4gIFRoZSBleGFjdCBiZWhhdmlvciBk ZXBlbmRzIG9uIHRoZSB2YWx1ZSBvZiBAdmFye2FyZ30KKyhpbnRlcmFjdGl2ZWx5LCB0aGUg cHJlZml4IGFyZ3VtZW50KToKKworQHRhYmxlIEBhc2lzCisKK0BpdGVtIEBjb2Rle25pbH0g b3Igb21pdHRlZAorU3RhcnQgb3Igc3dpdGNoIHRvIHRoZSBkZWZhdWx0IEVzaGVsbCBzZXNz aW9uLiAgVGhpcyBpcyB0aGUgYmVoYXZpb3IKK3doZW4gdHlwaW5nIEBrYmR7TS14IGVzaGVs bCBAa2V5e1JFVH19LgorCitAaXRlbSBhIG51bWJlcgorU3RhcnQgb3Igc3dpdGNoIHRvIHRo ZSBFc2hlbGwgc2Vzc2lvbiB3aXRoIHRoZSBzcGVjaWZpZWQgbnVtYmVyIChlLmcuQDoKK0Bz YW1weyplc2hlbGwqPDI+fSkuCisKK0BpdGVtIGFueXRoaW5nIGVsc2UKK1N0YXJ0IGEgbmV3 IEVzaGVsbCBzZXNzaW9uLCBubyBtYXR0ZXIgaWYgYW5vdGhlciBvbmUgYWxyZWFkeSBleGlz dHMuCisKK0BlbmQgdGFibGUKK0BlbmQgZGVmZm4KKworQG5vZGUgT25lLU9mZiBDb21tYW5k cworQHNlY3Rpb24gT25lLU9mZiBDb21tYW5kcworQGNpbmRleCBjb21tYW5kIGludm9jYXRp b24sIGZyb20gYW55d2hlcmUKKworWW91IGNhbiBhbHNvIHJ1biBpbmRpdmlkdWFsIEVzaGVs bCBjb21tYW5kcyBmcm9tIGFueXdoZXJlIHdpdGhpbiBFbWFjczoKKworQGRlZmZuIENvbW1h bmQgZXNoZWxsLWNvbW1hbmQgY29tbWFuZCAmb3B0aW9uYWwgdG8tY3VycmVudC1idWZmZXIK K0V4ZWN1dGUgdGhlIEVzaGVsbCBjb21tYW5kIHN0cmluZyBAdmFye2NvbW1hbmR9IGFuZCBz aG93IHRoZSBvdXRwdXQgaW4gYQorYnVmZmVyLiAgSWYgQHZhcnt0by1jdXJyZW50LWJ1ZmZl cn0gaXMgbm9uLUBjb2Rle25pbH0gKGludGVyYWN0aXZlbHksCit3aXRoIHRoZSBwcmVmaXgg YXJndW1lbnQpLCB0aGVuIGluc2VydCBvdXRwdXQgaW50byB0aGUgY3VycmVudCBidWZmZXIg YXQKK3BvaW50LgorCitXaGVuIHRoZSBjb21tYW5kIGVuZHMgd2l0aCBAa2JkeyZ9LCBFc2hl bGwgd2lsbCBldmFsdWF0ZSB0aGUgY29tbWFuZAorYXN5bmNocm9ub3VzbHkuICBPdGhlcndp c2UsIGl0IHdpbGwgd2FpdCB1bnRpbCB0aGUgY29tbWFuZCBoYXMgZmluaXNoZWQKK2V4ZWN1 dGlvbi4KK0BlbmQgZGVmZm4KKworQGRlZnVuIGVzaGVsbC1jb21tYW5kLXJlc3VsdCBjb21t YW5kICZvcHRpb25hbCBzdGF0dXMtdmFyCitFeGVjdXRlIHRoZSBFc2hlbGwgY29tbWFuZCBz dHJpbmcgQHZhcntjb21tYW5kfSBhbmQgcmV0dXJuIHRoZSByZXN1bHQsCitsaWtlIHVzaW5n IHRoZSB2YXJpYWJsZSBAY29kZXskJH0gaW4gYW4gaW50ZXJhY3RpdmUgc2Vzc2lvbgorKEBw eHJlZntWYXJpYWJsZXN9KS4gIElmIEB2YXJ7c3RhdHVzLXZhcn0gaXMgYSBzeW1ib2wsIHRo aXMgZnVuY3Rpb24KK3dpbGwgc2V0IGl0IHRvIHRoZSBleGl0IHN0YXR1cyBvZiB0aGUgY29t bWFuZCAobGlrZSB1c2luZyB0aGUgdmFyaWFibGUKK0Bjb2RleyQ/fSBpbiBhbiBpbnRlcmFj dGl2ZSBzZXNzaW9uKS4KK0BlbmQgZGVmdW4KKworQG5vZGUgU2NyaXB0cworQHNlY3Rpb24g U2NyaXB0cworQGNpbmRleCBzY3JpcHRzCisKK0BjbWluZGV4IHNvdXJjZQorQGNtaW5kZXgg LgorTGlrZSBvdGhlciBzaGVsbHMsIHlvdSBjYW4gY3JlYXRlIEVzaGVsbCBAZGZue3Njcmlw dHN9LiAgQW4gRXNoZWxsCitzY3JpcHQgaXMgc2ltcGx5IGEgZmlsZSBjb250YWluaW5nIGEg c2VxdWVuY2Ugb2YgY29tbWFuZHMgdGhhdCB3aWxsIGJlCitleGVjdXRlZCBhcyB0aG91Z2gg eW91IGVudGVyZWQgdGhlbSBvbmUgYXQgYSB0aW1lIGluIGFuIGludGVyYWN0aXZlCitFc2hl bGwgc2Vzc2lvbi4gIFlvdSBjYW4gaW52b2tlIHRoZXNlIHNjcmlwdHMgZnJvbSB3aXRoaW4g RXNoZWxsIHdpdGgKK0Bjb21tYW5ke3NvdXJjZX0sIHdoaWNoIHdpbGwgcnVuIHRoZSBzY3Jp cHQgaW4gYSBzdWJzaGVsbC4gIElmIHlvdSB3aXNoCit0byBydW4gYSBzY3JpcHQgaW4geW91 ciBAZW1waHtjdXJyZW50fSBFc2hlbGwgZW52aXJvbm1lbnQsIHVzZSB0aGUKK0Bjb2Rley59 IGNvbW1hbmQgaW5zdGVhZC4KKworTGlrZSB3aXRoIGFsaWFzZXMgKEBweHJlZntBbGlhc2Vz fSksIEVzaGVsbCBzY3JpcHRzIGNhbiBhY2NlcHQgYW55CitudW1iZXIgb2YgYXJndW1lbnRz LiAgV2l0aGluIHRoZSBzY3JpcHQsIHlvdSBjYW4gcmVmZXIgdG8gdGhlc2Ugd2l0aAordGhl IHNwZWNpYWwgdmFyaWFibGVzIEBjb2RleyQwfSwgQGNvZGV7JDF9LCBAZG90c3t9LCBAY29k ZXskOX0sIGFuZAorQGNvZGV7JCp9LgorCitZb3UgY2FuIGFsc28gaW52b2tlIEVzaGVsbCBz Y3JpcHRzIGZyb20gb3V0c2lkZSBvZiBFc2hlbGw6CisKK0BkZWZ1biBlc2hlbGwtZXhlY3V0 ZS1maWxlIGZpbGUgJm9wdGlvbmFsIGFyZ3MgZGVzdGluYXRpb24KK0V4ZWN1dGUgdGhlIEVz aGVsbCBjb21tYW5kcyBjb250YWluZWQgaW4gQHZhcntmaWxlfSwgcGFzc2luZyBhbiBvcHRp b25hbAorbGlzdCBvZiBAdmFye2FyZ3N9IHRvIHRoZSBzY3JpcHQuICBJZiBAdmFye2Rlc3Rp bmF0aW9ufSBpcyBAY29kZXt0fSwKK3dyaXRlIHRoZSBjb21tYW5kIG91dHB1dCB0byB0aGUg Y3VycmVudCBidWZmZXIuICBJZiBAY29kZXtuaWx9LCBkb24ndAord3JpdGUgdGhlIG91dHB1 dCBhbnl3aGVyZS4gIEZvciBhbnkgb3RoZXIgdmFsdWUsIG91dHB1dCB0byB0aGUKK2NvcnJl c3BvbmRpbmcgRXNoZWxsIHRhcmdldCAoQHB4cmVme1JlZGlyZWN0aW9ufSkuCitAZW5kIGRl ZnVuCisKK0BjaW5kZXggYmF0Y2ggc2NyaXB0cworQGRlZnVuIGVzaGVsbC1iYXRjaC1maWxl CitUaGlzIGZ1bmN0aW9uIGxldHMgeW91IG1ha2UgYW4gRXNoZWxsIHNjcmlwdCBmaWxlIGV4 ZWN1dGFibGUgZnJvbQorb3V0c2lkZSBvZiBFbWFjcyBieSBhZGRpbmcgaXQgdG8gdGhlIHNj cmlwdCdzIGludGVycHJldGVyIGRpcmVjdGl2ZSBsaWtlCit0aGlzOgorCitAZXhhbXBsZQor IyEvdXNyL2Jpbi9lbnYgLVMgZW1hY3MgLS1iYXRjaCAtZiBlc2hlbGwtYmF0Y2gtZmlsZQor QGVuZCBleGFtcGxlCisKK0FzIHdpdGggb3RoZXIgd2F5cyBvZiBpbnZva2luZyBFc2hlbGwg c2NyaXB0cywgeW91IGNhbiBwYXNzIGV4dHJhCithcmd1bWVudHMgdG8gdGhlIHNjcmlwdCBv biB0aGUgY29tbWFuZCBsaW5lLgorQGVuZCBkZWZ1bgorCiBAbm9kZSBDb21tYW5kcwogQGNo YXB0ZXIgQ29tbWFuZHMKIApAQCAtMjA4LDcgKzMxOSw2IEBAIENvbW1hbmRzCiAqIEFsaWFz ZXM6OgogKiBSZW1vdGUgQWNjZXNzOjoKICogQ29udHJvbCBGbG93OjoKLSogU2NyaXB0czo6 CiBAZW5kIG1lbnUKIAogQG5vZGUgSW52b2NhdGlvbgpAQCAtMTU5NCwzMyArMTcwNCw2IEBA IENvbnRyb2wgRmxvdwogCiBAZW5kIHRhYmxlCiAKLUBub2RlIFNjcmlwdHMKLUBzZWN0aW9u IFNjcmlwdHMKLUBjbWluZGV4IHNvdXJjZQotQGZuaW5kZXggZXNoZWxsLWV4ZWN1dGUtZmls ZQotQGZuaW5kZXggZXNoZWxsLWJhdGNoLWZpbGUKLVlvdSBjYW4gcnVuIEVzaGVsbCBzY3Jp cHRzIG11Y2ggbGlrZSBzY3JpcHRzIGZvciBvdGhlciBzaGVsbHM7IHRoZSBtYWluCi1kaWZm ZXJlbmNlIGlzIHRoYXQgc2luY2UgRXNoZWxsIGlzIG5vdCBhIHN5c3RlbSBjb21tYW5kLCB5 b3UgaGF2ZSB0byBydW4KLWl0IGZyb20gd2l0aGluIEVtYWNzLiAgQW4gRXNoZWxsIHNjcmlw dCBpcyBzaW1wbHkgYSBmaWxlIGNvbnRhaW5pbmcgYQotc2VxdWVuY2Ugb2YgY29tbWFuZHMs IGFzIHdpdGggYWxtb3N0IGFueSBvdGhlciBzaGVsbCBzY3JpcHQuICBZb3UgY2FuCi1pbnZv a2Ugc2NyaXB0cyBmcm9tIHdpdGhpbiBFc2hlbGwgd2l0aCBAY29tbWFuZHtzb3VyY2V9LCBv ciBmcm9tCi1hbnl3aGVyZSBpbiBFbWFjcyB3aXRoIEBjb2Rle2VzaGVsbC1leGVjdXRlLWZp bGV9LiAgQWRkaXRpb25hbGx5LCB5b3UKLWNhbiBtYWtlIGFuIEVzaGVsbCBzY3JpcHQgZmls ZSBleGVjdXRhYmxlIGJ5IGNhbGxpbmcKLUBjb2Rle2VzaGVsbC1iYXRjaC1maWxlfSBpbiB0 aGUgaW50ZXJwcmV0ZXIgZGlyZWN0aXZlOgotCi1AZXhhbXBsZQotIyEvdXNyL2Jpbi9lbnYg LVMgZW1hY3MgLS1iYXRjaCAtZiBlc2hlbGwtYmF0Y2gtZmlsZQotQGVuZCBleGFtcGxlCi0K LUxpa2Ugd2l0aCBhbGlhc2VzIChAcHhyZWZ7QWxpYXNlc30pLCBFc2hlbGwgc2NyaXB0cyBj YW4gYWNjZXB0IGFueQotbnVtYmVyIG9mIGFyZ3VtZW50cy4gIFdpdGhpbiB0aGUgc2NyaXB0 LCB5b3UgY2FuIHJlZmVyIHRvIHRoZXNlIHdpdGgKLXRoZSBzcGVjaWFsIHZhcmlhYmxlcyBA Y29kZXskMH0sIEBjb2RleyQxfSwgQGRvdHN7fSwgQGNvZGV7JDl9LCBhbmQKLUBjb2RleyQq fS4KLQotQGNtaW5kZXggLgotSWYgeW91IHdpc2ggdG8gbG9hZCBhIHNjcmlwdCBpbnRvIHlv dXIgQGVtcGh7Y3VycmVudH0gZW52aXJvbm1lbnQsCi1yYXRoZXIgdGhhbiBpbiBhIHN1YnNo ZWxsLCB1c2UgdGhlIEBjb2Rley59IGNvbW1hbmQuCi0KIEBub2RlIEV4cGFuc2lvbgogQGNo YXB0ZXIgRXhwYW5zaW9uCiBFeHBhbnNpb24gaW4gYSBjb21tYW5kIHNoZWxsIGlzIHNvbWV3 aGF0IGxpa2UgbWFjcm8gZXhwYW5zaW9uIGluIG1hY3JvCi0tIAoyLjI1LjEKCg== --------------FGd60y3iY0cv3aS5CZgKW0bI-- From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 09 07:33:46 2024 Received: (at 71987) by debbugs.gnu.org; 9 Jul 2024 11:33:46 +0000 Received: from localhost ([127.0.0.1]:52233 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sR96P-00053R-T2 for submit@debbugs.gnu.org; Tue, 09 Jul 2024 07:33:46 -0400 Received: from eggs.gnu.org ([209.51.188.92]:34934) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sR96O-00053F-Ge for 71987@debbugs.gnu.org; Tue, 09 Jul 2024 07:33:44 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sR96D-0002PA-4M; Tue, 09 Jul 2024 07:33:33 -0400 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=o7sfcQIdLbc056JjUqYpBcuxdvlGMygbET5KJZe5oPA=; b=m4Ylrj1j5dmy EdiN/qSuRqKt99krSaGG59EaxLZzgvAyp6wLKaAaJZdYpQx+Oz8r6PeXs7unWn7MQ1AvSfeeSQoFY eeaRjExnXExq48v2onxsbUuOzwtkp+bh7c5N33ps45KpjpLLtmm5jpGKfrZwY9S5GSY1rX4+TEf6w WKmXRogx5377Q/M7NzGFyS9nEVEgOuKu+sX68eRVS9WkdGXdxF/mAbdOp8NlQbXjiK/sI7APjE9SB biP5U3qBt+cG5MRQ9835ONZY6JifcqCbJrsS6fSkyHb3jDkkS5R8Xh1ZYcgCrlwz8RxnQOL0WGdoK 7jvVH6WpaYaktMM8laqzfw==; Date: Tue, 09 Jul 2024 14:33:30 +0300 Message-Id: <86r0c2zto5.fsf@gnu.org> From: Eli Zaretskii To: Jim Porter In-Reply-To: (message from Jim Porter on Mon, 8 Jul 2024 20:47:00 -0700) Subject: Re: bug#71987: 30.0.60; [PATCH] Document Eshell entry points References: <86a5is16df.fsf@gnu.org> X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 71987 Cc: 71987@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: -3.3 (---) > Date: Mon, 8 Jul 2024 20:47:00 -0700 > Cc: 71987@debbugs.gnu.org > From: Jim Porter > > On 7/8/2024 4:16 AM, Eli Zaretskii wrote: > > This should tell that this is what happens if the user types just > > @kbd{M-x eshell @key{RET}}. I'd probably also say "@code{nil} or > > omitted". > > > > Please also think about adding more indexing for these sections. > > Done both of these (see attached). LGTM, thanks. From debbugs-submit-bounces@debbugs.gnu.org Tue Jul 09 13:06:34 2024 Received: (at 71987-done) by debbugs.gnu.org; 9 Jul 2024 17:06:35 +0000 Received: from localhost ([127.0.0.1]:53986 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sREIU-0000Pz-Kn for submit@debbugs.gnu.org; Tue, 09 Jul 2024 13:06:34 -0400 Received: from mail-pg1-f177.google.com ([209.85.215.177]:55530) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sREIT-0000Pi-TH for 71987-done@debbugs.gnu.org; Tue, 09 Jul 2024 13:06:34 -0400 Received: by mail-pg1-f177.google.com with SMTP id 41be03b00d2f7-6c5bcb8e8edso4018617a12.2 for <71987-done@debbugs.gnu.org>; Tue, 09 Jul 2024 10:06:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1720544723; x=1721149523; darn=debbugs.gnu.org; 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=DrNxEl1k9aHML4Qg1KZtIhZZrvBw6wVmQrcR6AigtDY=; b=PZf1EYdAbXt6ijOFIsUScgwgEkjLMN/uDsdpexzytb121UYiTSuE5V3Cz1HnJWolhE eSMjumUfuXWu5WM4INFFpQsKymNpSjQQHlKpXhx5jMYqKfDmh0lHWySvvpUY+eNRJb8b OqLRDC2NrR3IqVpAyWnjYuEfEmslgD9JGv6dltm3Mto1yJcIOr2pCkpMj369hUi7NnI9 l6hZbkEnGIUOb69C/ZGtAKb5gjatN3ZoCsrxcKtakYggrtYgA3WcmDjIpKqz6gqDVvVe K3pLriXTl+1KTPDHEbN7nzITLgtM+t7ZuVrUQ4khAaa3m7l+Oz6vwy5tPPrb2bfhSl5j qCXg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720544723; x=1721149523; 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=DrNxEl1k9aHML4Qg1KZtIhZZrvBw6wVmQrcR6AigtDY=; b=o6e0eU3bQIaMxi7Mr46koi7snyZhJJ54gitRDuq9jkS+UUSVbaKkqO4dw1RtrwVIyJ KRm2I0hsFThmeyWRZqtlU3en3ysfGYq9mnzOYcHB6wc6cGezBWmBn9gxQNoiUaxh5Wsl a0L8fExPeSDmWqj0PVHZPhLvw49w2+cMZDPxhl2R8ZDVsvhz8+omhxflKUrLMd97u0uM bIrs7Fp9N30yR6lg3Wwr8q62IwIfOWWlyAHQ86NTnOqX6yPn1J3QPXVDVDh+fmXGtqqm YXmKum7PZFymhcLZJ3yrvEbM0dDTdCjrJPFU7kxbHZvraLCZjlszHa5jxauXMYpSfQAE pU7w== X-Gm-Message-State: AOJu0YxxCfvxODKPOq1ZEeDu27j7zewyzW4USKbt6l5cH8ydN3pnTT7Q q+2baNiWYBkLy/7UDM2Aaba4YlP4pz9b2/5BkwDgCuO6jCfEi3ut X-Google-Smtp-Source: AGHT+IEKnlgLAKmbUu9+mkaanFPk8PfxYEbi9X9AMQBIHjbj6sTI0VJvXGUULm0vDfLZygxA+g8JtA== X-Received: by 2002:a05:6a00:130f:b0:705:951e:ed84 with SMTP id d2e1a72fcca58-70b43565d94mr4179928b3a.15.1720544720839; Tue, 09 Jul 2024 10:05:20 -0700 (PDT) Received: from [192.168.1.2] (syn-023-240-098-037.res.spectrum.com. [23.240.98.37]) by smtp.googlemail.com with ESMTPSA id d9443c01a7336-1fbb6ab6b9fsm18466145ad.138.2024.07.09.10.05.19 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 09 Jul 2024 10:05:19 -0700 (PDT) Message-ID: Date: Tue, 9 Jul 2024 10:05:21 -0700 MIME-Version: 1.0 Subject: Re: bug#71987: 30.0.60; [PATCH] Document Eshell entry points Content-Language: en-US To: Eli Zaretskii References: <86a5is16df.fsf@gnu.org> <86r0c2zto5.fsf@gnu.org> From: Jim Porter In-Reply-To: <86r0c2zto5.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: 71987-done Cc: 71987-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 7/9/2024 4:33 AM, Eli Zaretskii wrote: > LGTM, thanks. Thanks. Pushed to the release branch as 37475c9af7a. Closing this bug now. From unknown Mon Aug 18 21:49:21 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Wed, 07 Aug 2024 11:24:12 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator