From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: dalanicolai Newsgroups: gmane.emacs.bugs Subject: bug#54865: 29.0.50; Unclear docstring 'switch-to-buffer' Date: Tue, 12 Apr 2022 00:22:58 +0200 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000a22a2305dc686395" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37516"; mail-complaints-to="usenet@ciao.gmane.io" To: 54865@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Apr 12 00:24:18 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ne2SI-0009c8-68 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 12 Apr 2022 00:24:18 +0200 Original-Received: from localhost ([::1]:38434 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ne2SH-0001qT-At for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 11 Apr 2022 18:24:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34784) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ne2S2-0001qL-S4 for bug-gnu-emacs@gnu.org; Mon, 11 Apr 2022 18:24:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52388) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ne2S2-0007bY-H6 for bug-gnu-emacs@gnu.org; Mon, 11 Apr 2022 18:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ne2S2-00078q-CW for bug-gnu-emacs@gnu.org; Mon, 11 Apr 2022 18:24:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: dalanicolai Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 11 Apr 2022 22:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 54865 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.164971579627396 (code B ref -1); Mon, 11 Apr 2022 22:24:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Apr 2022 22:23:16 +0000 Original-Received: from localhost ([127.0.0.1]:46285 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ne2RH-00077n-MG for submit@debbugs.gnu.org; Mon, 11 Apr 2022 18:23:16 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:54184) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ne2RG-00077g-4n for submit@debbugs.gnu.org; Mon, 11 Apr 2022 18:23:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34684) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ne2RF-0001Pm-Vs for bug-gnu-emacs@gnu.org; Mon, 11 Apr 2022 18:23:14 -0400 Original-Received: from mail-yw1-x1134.google.com ([2607:f8b0:4864:20::1134]:36175) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ne2RD-0007YH-JQ for bug-gnu-emacs@gnu.org; Mon, 11 Apr 2022 18:23:13 -0400 Original-Received: by mail-yw1-x1134.google.com with SMTP id 00721157ae682-2ebd70a4cf5so123599577b3.3 for ; Mon, 11 Apr 2022 15:23:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=jMqdrLZfoX77Hk7pkU9Ba3lwLOiNM1ZQXISG52+u73Q=; b=I79n0vCR122H4bvPrU6hyXkLV8H0N3iWPUSIneIIUktc1LQKzCYlIZsVL6M6hy+vVW AkVeI86hOeYfv5jXiWeyOmqg/TgRv8/OhiG2UB99oZuLqSmakqWZNWH03R0YcsziwOsH 2pGbRVO3bBV4AJ/nmwlFt7U40rs+KsmWeCbiHynTa2U1BpLicEmFuTVYEBgwSp6Kx89T temqJuDaCpiEgo4jMpAHmp+FfQLo7qtY/2DTFmUrV/M6xCRHwH/V9JMOztggjX7PgM9T 6DVZV3FJ+rQIUO3bNJEObuwH4glIun933tvFTcMaRIfIMdvhAQU5VY/FYI7PqdEK3EMm kiMw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=jMqdrLZfoX77Hk7pkU9Ba3lwLOiNM1ZQXISG52+u73Q=; b=qeB6LgZX0xEibq59swYi5yvm/dROVm/HyKMuslXmvNMBSSncG8GTn06d1VOTYxTOfd BNsNNBF6NNEGjPB2toUBnfEKJcfSc0yuMIpZXKfhbltgDwzrw37Joq3529HD2kK8j54N 3Lf/yK+pFbLs13ftZdZm2ob1B+UwXsUbP7xuPVfiTv4XMS3aNS4IV6Xz4odHdLnv2Ry6 y00d6Z8gmD6hSgQOTpw8eTdbqNDzN75CLlXtz0sYdmVd/tJzJMPu8QJjfuMbXV15evy0 pQk2jzC5FURI8URuBW7H5Iztweh/DTbXBn79dSkbnDKilTYoN1Pe4fNBEXaGYS6g6hJY 0OQQ== X-Gm-Message-State: AOAM5331n/HWCmqhugRYgsylEG40RvgEKQaVz5WfxW6dTTjrh6EJ16KQ 98N9b9GfDlxc+YGeiEFSIYWfrKuK27Yh6E753NA8oFeobfxsHg== X-Google-Smtp-Source: ABdhPJxCs/Cahe2L/GptASUiOypXAHbZywJ7gELplGGAaM0fEcbMYwDmAeosALviIuS7SPnA1JYKg3lmU2xub1rBVEw= X-Received: by 2002:a81:790a:0:b0:2eb:5573:9338 with SMTP id u10-20020a81790a000000b002eb55739338mr27579649ywc.8.1649715789833; Mon, 11 Apr 2022 15:23:09 -0700 (PDT) Received-SPF: pass client-ip=2607:f8b0:4864:20::1134; envelope-from=dalanicolai@gmail.com; helo=mail-yw1-x1134.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, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:229739 Archived-At: --000000000000a22a2305dc686395 Content-Type: text/plain; charset="UTF-8" The docstring of `switch-to-buffer` states: "If BUFFER-OR-NAME is a string that does not identify an existing buffer, create a buffer with that name." However, this is only true when called interactively. Although the previous paragraph is about interactive use, to me, it is not clear that the 'relevant' paragraph is still only about interactive use. (for example, I assume that the next paragraph about the NORECORD argument is about general use) It is no critical bug, but at least I guess it is nice to have it reported. In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.31, cairo version 1.17.4) of 2022-01-29 built on fedora Repository revision: 96533c18b7f9d75dce9e6bb534a16ed4ccf44ad1 Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12014000 System Description: Fedora Linux 35 (Workstation Edition) Configured using: 'configure --with-modules --with-cairo --with-native-compilation --with-json' Configured features: ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ JPEG JSON LIBSELINUX LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS X11 XDBE XIM XPM GTK3 ZLIB Important settings: value of $LANG: en_US.UTF-8 value of $XMODIFIERS: @im=ibus locale-coding-system: utf-8-unix Major mode: Help Minor modes in effect: marginalia-mode: t savehist-mode: t vertico-mode: t global-evil-surround-mode: t evil-surround-mode: t recentf-mode: t shell-dirtrack-mode: t evil-mode: t evil-local-mode: t windmove-mode: t global-undo-tree-mode: t undo-tree-mode: t override-global-mode: t tooltip-mode: t global-eldoc-mode: t show-paren-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t buffer-read-only: t line-number-mode: t indent-tabs-mode: t transient-mark-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message yank-media rmc rfc822 mml mml-sec epa epg rfc6068 epg-config gnus-util mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr shortdoc debug backtrace find-func imenu cl-print help-fns radix-tree image-mode dired dired-loaddefs exif mule-util time-date cursor-sensor consult-vertico consult bookmark pp format-all language-id inheritenv gitter derived pcase let-alist posframe transient format-spec request autorevert filenotify mail-utils notifications dbus avy shr-tag-pre-highlight language-detection shr text-property-search pixel-fill kinsoku puny svg xml ewoc marginalia savehist orderless vertico evil-surround evil-nerd-commenter evil-nerd-commenter-operator evil-nerd-commenter-sdk sgml-mode facemenu dom which-key bind-map recentf tree-widget wid-edit evil evil-keybindings evil-integration evil-maps evil-commands reveal flyspell ispell evil-jumps evil-command-window evil-types evil-search evil-ex shell pcomplete comint ansi-color evil-macros evil-repeat evil-states evil-core comp comp-cstr warnings rx advice evil-common windmove thingatpt rect evil-digraphs evil-vars ring edmacro kmacro undo-tree diff cl-extra help-mode use-package use-package-ensure use-package-delight use-package-diminish use-package-bind-key bind-key easy-mmode use-package-core finder-inf info package browse-url url url-proxy url-privacy url-expand url-methods url-history url-cookie url-domsuf url-util mailcap url-handlers url-parse auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs password-cache json map url-vars seq gv subr-x byte-opt bytecomp byte-compile cconv cl-loaddefs cl-lib chemacs iso-transl tooltip eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type elisp-mode mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode lisp-mode prog-mode register page tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax font-core term/tty-colors frame minibuffer cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite emoji-zwj charscript charprop case-table epa-hook jka-cmpr-hook help simple abbrev obarray cl-preloaded nadvice button loaddefs faces cus-face macroexp files window text-properties overlay sha1 md5 base64 format env code-pages mule custom widget keymap hashtable-print-readable backquote threads dbusbind inotify dynamic-setting system-font-setting font-render-setting cairo move-toolbar gtk x-toolkit x multi-tty make-network-process native-compile emacs) Memory information: ((conses 16 384898 29104) (symbols 48 23623 0) (strings 32 128809 5607) (string-bytes 1 4615770) (vectors 16 228260) (vector-slots 8 1475141 114223) (floats 8 91020 141) (intervals 56 1457 297) (buffers 992 16)) --000000000000a22a2305dc686395 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
The docstring of `switch-to-buffer` states:

"I= f BUFFER-OR-NAME is a string that does not identify an existing
buffer, = create a buffer with that name."

However, this is only true whe= n called interactively. Although the
previous paragraph is about interac= tive use, to me, it is not clear that
the 'relevant' paragraph i= s still only about interactive use.
(for example, I assume that the next= paragraph about the NORECORD argument is about general use)

It is n= o critical bug, but at least I guess it is nice to have it reported.

In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.= 31, cairo version 1.17.4)
=C2=A0of 2022-01-29 built on fedora
Reposit= ory revision: 96533c18b7f9d75dce9e6bb534a16ed4ccf44ad1
Repository branch= : master
Windowing system distributor 'The X.Org Foundation', ve= rsion 11.0.12014000
System Description: Fedora Linux 35 (Workstation Edi= tion)

Configured using:
=C2=A0'configure --with-modules --wit= h-cairo --with-native-compilation
=C2=A0--with-json'

Configur= ed features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFB= UZZ JPEG JSON
LIBSELINUX LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUM= PER PNG RSVG
SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS X11 = XDBE XIM XPM
GTK3 ZLIB

Important settings:
=C2=A0 value of $LA= NG: en_US.UTF-8
=C2=A0 value of $XMODIFIERS: @im=3Dibus
=C2=A0 locale= -coding-system: utf-8-unix

Major mode: Help

Minor modes in ef= fect:
=C2=A0 marginalia-mode: t
=C2=A0 savehist-mode: t
=C2=A0 ver= tico-mode: t
=C2=A0 global-evil-surround-mode: t
=C2=A0 evil-surround= -mode: t
=C2=A0 recentf-mode: t
=C2=A0 shell-dirtrack-mode: t
=C2= =A0 evil-mode: t
=C2=A0 evil-local-mode: t
=C2=A0 windmove-mode: t=C2=A0 global-undo-tree-mode: t
=C2=A0 undo-tree-mode: t
=C2=A0 over= ride-global-mode: t
=C2=A0 tooltip-mode: t
=C2=A0 global-eldoc-mode: = t
=C2=A0 show-paren-mode: t
=C2=A0 electric-indent-mode: t
=C2=A0 = mouse-wheel-mode: t
=C2=A0 tool-bar-mode: t
=C2=A0 menu-bar-mode: t=C2=A0 file-name-shadow-mode: t
=C2=A0 global-font-lock-mode: t
=C2= =A0 font-lock-mode: t
=C2=A0 blink-cursor-mode: t
=C2=A0 auto-composi= tion-mode: t
=C2=A0 auto-encryption-mode: t
=C2=A0 auto-compression-m= ode: t
=C2=A0 buffer-read-only: t
=C2=A0 line-number-mode: t
=C2= =A0 indent-tabs-mode: t
=C2=A0 transient-mark-mode: t

Load-path s= hadows:
None found.

Features:
(shadow sort mail-extr emacsbug = message yank-media rmc rfc822 mml
mml-sec epa epg rfc6068 epg-config gnu= s-util mm-decode mm-bodies
mm-encode mail-parse rfc2231 mailabbrev gmm-u= tils mailheader sendmail
rfc2047 rfc2045 ietf-drums mm-util mail-prsvr s= hortdoc debug backtrace
find-func imenu cl-print help-fns radix-tree ima= ge-mode dired
dired-loaddefs exif mule-util time-date cursor-sensor cons= ult-vertico
consult bookmark pp format-all language-id inheritenv gitter= derived
pcase let-alist posframe transient format-spec request autoreve= rt
filenotify mail-utils notifications dbus avy shr-tag-pre-highlightlanguage-detection shr text-property-search pixel-fill kinsoku puny svgxml ewoc marginalia savehist orderless vertico evil-surround
evil-nerd-= commenter evil-nerd-commenter-operator evil-nerd-commenter-sdk
sgml-mode= facemenu dom which-key bind-map recentf tree-widget wid-edit
evil evil-= keybindings evil-integration evil-maps evil-commands reveal
flyspell isp= ell evil-jumps evil-command-window evil-types evil-search
evil-ex shell = pcomplete comint ansi-color evil-macros evil-repeat
evil-states evil-cor= e comp comp-cstr warnings rx advice evil-common
windmove thingatpt rect = evil-digraphs evil-vars ring edmacro kmacro
undo-tree diff cl-extra help= -mode use-package use-package-ensure
use-package-delight use-package-dim= inish use-package-bind-key bind-key
easy-mmode use-package-core finder-i= nf info package browse-url url
url-proxy url-privacy url-expand url-meth= ods url-history url-cookie
url-domsuf url-util mailcap url-handlers url-= parse auth-source cl-seq
eieio eieio-core cl-macs eieio-loaddefs passwor= d-cache json map url-vars
seq gv subr-x byte-opt bytecomp byte-compile c= conv cl-loaddefs cl-lib
chemacs iso-transl tooltip eldoc paren electric = uniquify ediff-hook
vc-hooks lisp-float-type elisp-mode mwheel term/x-wi= n x-win
term/common-win x-dnd tool-bar dnd fontset image regexp-opt frin= ge
tabulated-list replace newcomment text-mode lisp-mode prog-mode regis= ter
page tab-bar menu-bar rfn-eshadow isearch easymenu timer select
s= croll-bar mouse jit-lock font-lock syntax font-core term/tty-colors
fram= e minibuffer cl-generic cham georgian utf-8-lang misc-lang
vietnamese ti= betan thai tai-viet lao korean japanese eucjp-ms cp51932
hebrew greek ro= manian slovak czech european ethiopic indian cyrillic
chinese composite = emoji-zwj charscript charprop case-table epa-hook
jka-cmpr-hook help sim= ple abbrev obarray cl-preloaded nadvice button
loaddefs faces cus-face m= acroexp files window text-properties overlay
sha1 md5 base64 format env = code-pages mule custom widget keymap
hashtable-print-readable backquote = threads dbusbind inotify
dynamic-setting system-font-setting font-render= -setting cairo
move-toolbar gtk x-toolkit x multi-tty make-network-proce= ss
native-compile emacs)

Memory information:
((conses 16 38489= 8 29104)
=C2=A0(symbols 48 23623 0)
=C2=A0(strings 32 128809 5607)=C2=A0(string-bytes 1 4615770)
=C2=A0(vectors 16 228260)
=C2=A0(vect= or-slots 8 1475141 114223)
=C2=A0(floats 8 91020 141)
=C2=A0(interval= s 56 1457 297)
=C2=A0(buffers 992 16))
--000000000000a22a2305dc686395--