procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; Fix documentation of 'completing-read' and friends

Browse source 
* src/minibuf.c (Fcompleting_read):
* lisp/minibuffer.el (read-file-name):
* doc/lispref/minibuf.texi (Minibuffer Completion):
* etc/NEWS: Fix typos and wording of the description of the
REQUIRE-MATCH argument to 'completing-read'.
This commit is contained in:
Eli Zaretskii 2022-06-10 14:22:18 +03:00
parent 0afaf53c6e
commit dc09759c1d
4 changed files with 7 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/lispref/minibuf.texi
View file

@ -1122,9 +1122,9 @@ completion command (i.e., one of the commands in
not an element of @var{collection}. @xref{Completion Commands}.
@item
If a function, the function is called with the input as the only
argument. The function should return a non-@code{nil} value of the
input is acceptable.
If a function, it is called with the input as the only argument. The
function should return a non-@code{nil} value if the input is
acceptable.
@item
Any other value of @var{require-match} behaves like @code{t}, except

2
etc/NEWS
View file

@ -1952,7 +1952,7 @@ Previously it produced a nonsense value, -1, that was never intended.
* Lisp Changes in Emacs 29.1
+++
** 'completing-read' now allows a function as REQUIRE-MATCH.
** 'completing-read' now allows a function as its REQUIRE-MATCH argument.
This function is called to see whether what the user has typed in is a
match. This is also available from functions that call
'completing-read', like 'read-file-name'.

4
lisp/minibuffer.el
View file

@ -3161,8 +3161,8 @@ Fourth arg MUSTMATCH can take the following values:
input, but she needs to confirm her choice if she called
`minibuffer-complete' right before `minibuffer-complete-and-exit'
and the input is not an existing file.
- a function, which will be called with the input as the parameter.
If it returns a non-nil value, we exit with that value.
- a function, which will be called with the input as the argument.
If it returns a non-nil value, the minibuffer is exited with that value.
- anything else behaves like t except that typing RET does not exit if it
does non-null completion.

2
src/minibuf.c
View file

@ -2010,7 +2010,7 @@ REQUIRE-MATCH can take the following values:
`minibuffer-complete' right before `minibuffer-complete-and-exit'
and the input is not an element of COLLECTION.
- a function, which will be called with the input as the parameter.
If it returns a non-nil value, we exit with that value.
If it returns a non-nil value, the minibuffer is exited with that value.
- anything else behaves like t except that typing RET does not exit if it
does non-null completion.