diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2018-03-20 08:59:39 -0700 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2018-03-20 08:59:39 -0700 |
commit | a5f190dd658419e9328a846a1044b8294a7632d9 (patch) | |
tree | 551602b98e8d918935d9e36d5f03daafbc710305 /src/minibuf.c | |
parent | 97608c60b8e0d01d59d51e32a9fdbd2bb3e2da58 (diff) | |
parent | 23527013c79607ba19536ccce85725a91b0033a5 (diff) | |
download | emacs-a5f190dd658419e9328a846a1044b8294a7632d9.tar.gz |
Merge from origin/emacs-26
23527013c7 ; Rewrap doc string
4328d5f744 Correct Info link markup
2fb52abd9e Improve documentation of 'with-help-window'
ec08c62f03 Minor improvements in building.texi
663aafe1ff * lisp/textmodes/bibtex.el (bibtex-mark-entry): activate mark
05781b2e88 ; Spelling fix
aa40014ba3 * doc/emacs/building.texi (Starting GUD): Mention 'guiler'.
23072e468f Yet more proofreading of the Emacs manual
ba5a372540 * doc/emacs/rmail.texi: Fix broken link.
6b2210cc29 ; Spelling fix
067c8c4f5b Fix recently-added POP doc glitch
fb3dc0e8aa More proofreading of the Emacs manual
a776ce7be6 Fix typo in the Emacs manual's VC chapter
7f27d42f0b Pass json-readtable-error data as a list (bug#30489)
10bd3b3af8 Improve word motion docs (Bug#30815)
2b8507fbdc Replace "carriage-return" by "carriage return" in manuals
2616cd94f1 Minor copyedits in mule.texi
36a1d52814 Fix problems caused by fontconfig-2.13.0
Diffstat (limited to 'src/minibuf.c')
-rw-r--r-- | src/minibuf.c | 46 |
1 files changed, 23 insertions, 23 deletions
diff --git a/src/minibuf.c b/src/minibuf.c index 95e62ceddab..45cf15224a5 100644 --- a/src/minibuf.c +++ b/src/minibuf.c @@ -1626,13 +1626,13 @@ COLLECTION can also be a function to do the completion itself. PREDICATE limits completion to a subset of COLLECTION. See `try-completion', `all-completions', `test-completion', and `completion-boundaries', for more details on completion, -COLLECTION, and PREDICATE. See also Info nodes `(elisp)Basic Completion' -for the details about completion, and `(elisp)Programmed Completion' for -expectations from COLLECTION when it's a function. +COLLECTION, and PREDICATE. See also Info node `(elisp)Basic Completion' +for the details about completion, and Info node `(elisp)Programmed +Completion' for expectations from COLLECTION when it's a function. REQUIRE-MATCH can take the following values: -- t means that the user is not allowed to exit unless - the input is (or completes to) an element of COLLECTION or is null. +- t means that the user is not allowed to exit unless the input is (or + completes to) an element of COLLECTION or is null. - nil means that the user can exit with any input. - `confirm' means that the user can exit with any input, but she needs to confirm her choice if the input is not an element of COLLECTION. @@ -1643,19 +1643,19 @@ REQUIRE-MATCH can take the following values: - anything else behaves like t except that typing RET does not exit if it does non-null completion. -If the input is null, `completing-read' returns DEF, or the first element -of the list of default values, or an empty string if DEF is nil, -regardless of the value of REQUIRE-MATCH. +If the input is null, `completing-read' returns DEF, or the first +element of the list of default values, or an empty string if DEF is +nil, regardless of the value of REQUIRE-MATCH. If INITIAL-INPUT is non-nil, insert it in the minibuffer initially, - with point positioned at the end. - If it is (STRING . POSITION), the initial input is STRING, but point - is placed at _zero-indexed_ position POSITION in STRING. (*Note* - that this is different from `read-from-minibuffer' and related - functions, which use one-indexing for POSITION.) This feature is - deprecated--it is best to pass nil for INITIAL-INPUT and supply the - default value DEF instead. The user can yank the default value into - the minibuffer easily using \\<minibuffer-local-map>\\[next-history-element]. + with point positioned at the end. If it is (STRING . POSITION), the + initial input is STRING, but point is placed at _zero-indexed_ + position POSITION in STRING. (*Note* that this is different from + `read-from-minibuffer' and related functions, which use one-indexing + for POSITION.) This feature is deprecated--it is best to pass nil + for INITIAL-INPUT and supply the default value DEF instead. The + user can yank the default value into the minibuffer easily using + \\<minibuffer-local-map>\\[next-history-element]. HIST, if non-nil, specifies a history list and optionally the initial position in the list. It can be a symbol, which is the history list @@ -1663,16 +1663,16 @@ HIST, if non-nil, specifies a history list and optionally the initial that case, HISTVAR is the history list variable to use, and HISTPOS is the initial position (the position in the list used by the minibuffer history commands). For consistency, you should also - specify that element of the history as the value of - INITIAL-INPUT. (This is the only case in which you should use - INITIAL-INPUT instead of DEF.) Positions are counted starting from - 1 at the beginning of the list. The variable `history-length' - controls the maximum length of a history list. + specify that element of the history as the value of INITIAL-INPUT. + (This is the only case in which you should use INITIAL-INPUT instead + of DEF.) Positions are counted starting from 1 at the beginning of + the list. The variable `history-length' controls the maximum length + of a history list. DEF, if non-nil, is the default value or the list of default values. -If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits - the current input method and the setting of `enable-multibyte-characters'. +If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits the + current input method and the setting of `enable-multibyte-characters'. Completion ignores case if the ambient value of `completion-ignore-case' is non-nil. |