GNU logs - #71987, boring messages


Message sent to bug-gnu-emacs@HIDDEN:


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--




Message sent:


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


Message sent to bug-gnu-emacs@HIDDEN:


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.





Last modified: Mon, 8 Jul 2024 11:30:02 UTC

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