From: "David Röthlisberger" <david@rothlis.net>
To: 11201@debbugs.gnu.org
Subject: bug#11201: 24.0.93; ido.el: Documentation for C-j in ido-find-file and ido-switch-buffer
Date: Sun, 8 Apr 2012 13:33:22 +0100 [thread overview]
Message-ID: <8793BE32-4C7A-4D70-BA7B-987FF49475C4@rothlis.net> (raw)
The documentation string for 'ido-find-file' has the following description for 'C-j':
> Select the current prompt as the buffer or file.
> If no buffer or file is found, prompt for a new one.
I found this rather confusing. The word "prompt" isn't used anywhere else in the documentation string to mean what the user has typed; whereas "string", "input string" and "substring" are used several times. 'ido-switch-buffer' has the same problem.
When I was a new user of 'ido', the most annoying thing was not being able to visit a new, non-existent file or buffer, because the name I wanted would match part of another file/buffer name. I reading the documentation several times but still didn't realize that's what C-j does.
The second sentence ("If no buffer or file is found, prompt for a new one") seems to be flat-out false. I have not been able to reproduce this behaviour under ido-find-file or ido-switch-buffer, with empty input or otherwise.
Patch below.
Kind regards,
Dave.
From: David Rothlisberger <david@rothlis.net>
Date: Sun, 8 Apr 2012 12:56:56 +0100
Subject: [PATCH] * ido.el: Documentation for C-j in ido-find-file and
ido-switch-buffer.
---
lisp/ido.el | 6 ++----
1 file changed, 2 insertions(+), 4 deletions(-)
diff --git a/lisp/ido.el b/lisp/ido.el
index fe94c7f..4f1bf04 100644
--- a/lisp/ido.el
+++ b/lisp/ido.el
@@ -4046,8 +4046,7 @@ (defun ido-switch-buffer ()
RET Select the buffer at the front of the list of matches. If the
list is empty, possibly prompt to create new buffer.
-\\[ido-select-text] Select the current prompt as the buffer.
-If no buffer is found, prompt for a new one.
+\\[ido-select-text] Use the current input string verbatim.
\\[ido-next-match] Put the first element at the end of the list.
\\[ido-prev-match] Put the last element at the start of the list.
@@ -4133,8 +4132,7 @@ (defun ido-find-file ()
RET Select the file at the front of the list of matches. If the
list is empty, possibly prompt to create new file.
-\\[ido-select-text] Select the current prompt as the buffer or file.
-If no buffer or file is found, prompt for a new one.
+\\[ido-select-text] Use the current input string verbatim.
\\[ido-next-match] Put the first element at the end of the list.
\\[ido-prev-match] Put the last element at the start of the list.
--
1.7.9.2
next reply other threads:[~2012-04-08 12:33 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-04-08 12:33 David Röthlisberger [this message]
2012-06-19 18:12 ` bug#11201: Bug report about IDO docstring for C-j Stefan Monnier
2012-06-19 18:47 ` Kim Storm
2012-06-20 15:52 ` bug#11201: 24.0.93; ido.el: Documentation for C-j in ido-find-file and ido-switch-buffer Stefan Monnier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=8793BE32-4C7A-4D70-BA7B-987FF49475C4@rothlis.net \
--to=david@rothlis.net \
--cc=11201@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).