X-Loop: help-debbugs@HIDDEN Subject: bug#71987: 30.0.60; [PATCH] Document Eshell entry points Resent-From: Jim Porter <jporterbugs@HIDDEN> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> Resent-CC: bug-gnu-emacs@HIDDEN Resent-Date: Mon, 08 Jul 2024 04:30:02 +0000 Resent-Message-ID: <handler.71987.B.17204129742947 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: report 71987 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 71987 <at> debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@HIDDEN Received: via spool by submit <at> debbugs.gnu.org id=B.17204129742947 (code B ref -1); Mon, 08 Jul 2024 04:30:02 +0000 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 <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1sQg0L-0000lT-LM for submit <at> 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 <jporterbugs@HIDDEN>) id 1sQg0J-0000lL-GT for submit <at> 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 <jporterbugs@HIDDEN>) id 1sQg0E-0002eJ-Ji for bug-gnu-emacs@HIDDEN; 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 <jporterbugs@HIDDEN>) id 1sQg0C-0002HA-KQ for bug-gnu-emacs@HIDDEN; Mon, 08 Jul 2024 00:29:26 -0400 Received: by mail-pg1-x531.google.com with SMTP id 41be03b00d2f7-7163489149eso2526273a12.1 for <bug-gnu-emacs@HIDDEN>; 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 <bug-gnu-emacs@HIDDEN> (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: <e97bb7d2-2836-9dbe-3380-ea48ae3b213c@HIDDEN> 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 From: Jim Porter <jporterbugs@HIDDEN> Received-SPF: pass client-ip=2607:f8b0:4864:20::531; envelope-from=jporterbugs@HIDDEN; 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-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -2.3 (--) This is a multi-part message in MIME format. --------------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--
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Jim Porter <jporterbugs@HIDDEN> Subject: bug#71987: Acknowledgement (30.0.60; [PATCH] Document Eshell entry points) Message-ID: <handler.71987.B.17204129742947.ack <at> debbugs.gnu.org> References: <e97bb7d2-2836-9dbe-3380-ea48ae3b213c@HIDDEN> X-Gnu-PR-Message: ack 71987 X-Gnu-PR-Package: emacs X-Gnu-PR-Keywords: patch Reply-To: 71987 <at> debbugs.gnu.org Date: Mon, 08 Jul 2024 04:30:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-gnu-emacs@HIDDEN If you wish to submit further information on this problem, please send it to 71987 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 71987: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D71987 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
X-Loop: help-debbugs@HIDDEN Subject: bug#71987: 30.0.60; [PATCH] Document Eshell entry points Resent-From: Eli Zaretskii <eliz@HIDDEN> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> Resent-CC: bug-gnu-emacs@HIDDEN Resent-Date: Mon, 08 Jul 2024 11:17:02 +0000 Resent-Message-ID: <handler.71987.B71987.172043739023008 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: followup 71987 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Jim Porter <jporterbugs@HIDDEN> Cc: 71987 <at> debbugs.gnu.org Received: via spool by 71987-submit <at> debbugs.gnu.org id=B71987.172043739023008 (code B ref 71987); Mon, 08 Jul 2024 11:17:02 +0000 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 <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1sQmM9-0005z2-Jm for submit <at> 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 <eliz@HIDDEN>) id 1sQmM7-0005yp-7S for 71987 <at> 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 <eliz@HIDDEN>) 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@HIDDEN> From: Eli Zaretskii <eliz@HIDDEN> In-Reply-To: <e97bb7d2-2836-9dbe-3380-ea48ae3b213c@HIDDEN> (message from Jim Porter on Sun, 7 Jul 2024 21:29:22 -0700) References: <e97bb7d2-2836-9dbe-3380-ea48ae3b213c@HIDDEN> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -3.3 (---) > Date: Sun, 7 Jul 2024 21:29:22 -0700 > From: Jim Porter <jporterbugs@HIDDEN> > > 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.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.