From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#37178: 26.2; doc strings of `eshell' and `eshell-buffer-name' Date: Sat, 24 Aug 2019 16:37:50 -0700 (PDT) Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="247266"; mail-complaints-to="usenet@blaine.gmane.org" To: 37178@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Aug 25 01:38:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i1fbn-0012DV-5K for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Aug 2019 01:38:11 +0200 Original-Received: from localhost ([::1]:39862 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1fbm-00066u-42 for geb-bug-gnu-emacs@m.gmane.org; Sat, 24 Aug 2019 19:38:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49215) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1fbf-00066c-RS for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:38:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i1fbe-00038E-QS for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:38:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34561) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i1fbe-00037v-Ku for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:38:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1i1fbe-0001Cm-GG for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:38:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 24 Aug 2019 23:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 37178 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15666898794620 (code B ref -1); Sat, 24 Aug 2019 23:38:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 Aug 2019 23:37:59 +0000 Original-Received: from localhost ([127.0.0.1]:43382 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i1fba-0001CS-TZ for submit@debbugs.gnu.org; Sat, 24 Aug 2019 19:37:59 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:44292) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1i1fbZ-0001CJ-L8 for submit@debbugs.gnu.org; Sat, 24 Aug 2019 19:37:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49197) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1fbY-00066W-FR for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:37:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i1fbX-00032b-3e for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:37:56 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:49800) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1i1fbW-00031v-QM for bug-gnu-emacs@gnu.org; Sat, 24 Aug 2019 19:37:55 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x7ONYArh075227 for ; Sat, 24 Aug 2019 23:37:53 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2019-08-05; bh=qQQtNYtdxDy/3XklnNs53OqfdOLeWD2NqSX6AhvGTzg=; b=leM/0a/rUMTrRHk4ROxlAwnb74MZVXEhO3ZpqFA+RAQBMNZru/El8SE0t1Y1Q1GwXvk6 hueqz1IsVd/9yNnzFeXTPyJJtN3NJo8L/i8xOMLRo6/gYdWfLhsbWUISykuns+hHKhI5 L2rH1YUBo/ueslM9BUpelPm8kCdPyjUxRqNeFyKXnq1DIfea0ebcwSvVmuaCK7JkIj+B NcdPyeG0py6wLmqWYULrE77ZgS/EZa14NBCPrNPdiW8kMxGyCF8QVGVefgHXkf5l40Tb oz1qJwuPXg2O1pr3n0MO0eY6OAmGDQbgCO+/9r6Xr+X734k+dJM7I9EwTrzxzvyocV8B iQ== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2120.oracle.com with ESMTP id 2ujwvq21xb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 24 Aug 2019 23:37:52 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x7ONXkrB025224 for ; Sat, 24 Aug 2019 23:37:52 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 2ujw6g9y58-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 24 Aug 2019 23:37:51 +0000 Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id x7ONbpv6009591 for ; Sat, 24 Aug 2019 23:37:51 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4873.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9359 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908240261 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9359 signatures=668684 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1906280000 definitions=main-1908240262 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:165794 Archived-At: This is the `eshell' doc string: Create an interactive Eshell buffer. The buffer used for Eshell sessions is determined by the value of 'eshell-buffer-name'. If there is already an Eshell session active in that buffer, Emacs will simply switch to it. Otherwise, a new session will begin. A numeric prefix arg (as in 'C-u 42 M-x eshell RET') switches to the session with that number, creating it if necessary. A nonnumeric prefix arg means to create a new session. Returns the buffer selected (or created). That's a wall of text. But the problem to report here is that the _number_ of a session is unclear. What is it and, especially, what, if anything, does it have to do with `eshell-buffer-name'. Experimenting a bit, a guess is that the names of Eshell buffers use `eshell-buffer-name' followed, by all but the first, by "", where N =3D 2,3,4... as additional sessions are created. And with a numeric prefix arg M, `eshell' tries to find a session with buffer name ending in . E.g., I tried `M-x eshell' followed by `C-u M-x eshell'. The first created buffer `*eshell*', and the second created buffer `*eshell<2>*' (not `*eshell<4>*', BTW). This naming convention should be described in the doc string, in order to make clear (1) how `eshell-buffer-name' is used as a "base name" and (2) how the prefix arg relates to the buffer-name convention. Also, the doc string for variable `eshell-buffer-name' is poor. That's really where the use of the value as a "base name" needs to be described (i.e., make clear what is mean by "base name" and how multiple eshell buffers are named). In GNU Emacs 26.2 (build 1, x86_64-w64-mingw32) of 2019-04-13 Repository revision: fd1b34bfba8f3f6298df47c8e10b61530426f749 Windowing system distributor `Microsoft Corp.', version 10.0.17763 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''