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

Explicitly document read-string return value

Browse source 
* src/minibuf.c (Fread_string): Document return value explicitly.
Better document PROMPT argument, and reflow docstring.  (Bug#76797)
This commit is contained in:
Stefan Kangas 2025-03-07 18:10:53 +01:00
parent cf03c2b609
commit af8017b23f
1 changed files with 21 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
src/minibuf.c
View file

@ -1402,20 +1402,28 @@ and some related functions, which use zero-indexing for POSITION. */)
/* Functions that use the minibuffer to read various things. */ /* Functions that use the minibuffer to read various things. */
DEFUN ("read-string", Fread_string, Sread_string, 1, 5, 0, DEFUN ("read-string", Fread_string, Sread_string, 1, 5, 0,
doc: /* Read a string from the minibuffer, prompting with string PROMPT. doc: /* Read and return a string from the minibuffer, prompting with PROMPT.
If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
This argument has been superseded by DEFAULT-VALUE and should normally be nil PROMPT is a string, which should normally end with the string ": ".
in new code. It behaves as INITIAL-CONTENTS in `read-from-minibuffer' (which
see). If non-nil, second arg INITIAL-INPUT is a string to insert before
The third arg HISTORY, if non-nil, specifies a history list reading. This argument has been superseded by DEFAULT-VALUE and should
and optionally the initial position in the list. normally be nil in new code. It behaves as INITIAL-CONTENTS in
`read-from-minibuffer' (which see).
The third arg HISTORY, if non-nil, specifies a history list and
optionally the initial position in the list.
See `read-from-minibuffer' for details of HISTORY argument. See `read-from-minibuffer' for details of HISTORY argument.
Fourth arg DEFAULT-VALUE is the default value or the list of default values.
If non-nil, it is used for history commands, and as the value (or the first Fourth arg DEFAULT-VALUE is the default value or the list of default
element of the list of default values) to return if the user enters the values. If non-nil, it is used for history commands, and as the value
empty string. (or the first element of the list of default values) to return if the
Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits user enters the empty string.
the current input method and the setting of `enable-multibyte-characters'. */)
Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer
inherits the current input method and the setting of
`enable-multibyte-characters'. */)
(Lisp_Object prompt, Lisp_Object initial_input, Lisp_Object history, Lisp_Object default_value, Lisp_Object inherit_input_method) (Lisp_Object prompt, Lisp_Object initial_input, Lisp_Object history, Lisp_Object default_value, Lisp_Object inherit_input_method)
{ {
Lisp_Object val; Lisp_Object val;