diff options
| author | Eli Zaretskii | 2021-04-23 16:32:37 +0300 |
|---|---|---|
| committer | Eli Zaretskii | 2021-04-23 16:32:37 +0300 |
| commit | e44a0b7c79e20cd1841bd59f7a2c2a0698a1a3cd (patch) | |
| tree | 33494f8345cfcdc45d6944c67945ba18ea8d4947 | |
| parent | 87e5cc2ccbe3423640cd95d60f0b588d9d2bd029 (diff) | |
| download | emacs-e44a0b7c79e20cd1841bd59f7a2c2a0698a1a3cd.tar.gz emacs-e44a0b7c79e20cd1841bd59f7a2c2a0698a1a3cd.zip | |
Fix a recent change in minibuf.texi
* doc/lispref/minibuf.texi (Basic Completion)
(Programmed Completion): Improve wording, punctuation, and markup
of a recently-added text.
| -rw-r--r-- | doc/lispref/minibuf.texi | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index faee43b21a1..7cf2fcf68f2 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi | |||
| @@ -980,17 +980,17 @@ and @var{suffix} holds the text after point. | |||
| 980 | 980 | ||
| 981 | Normally completion operates on the whole string, so for all normal | 981 | Normally completion operates on the whole string, so for all normal |
| 982 | collections, this will always return @code{(0 . (length | 982 | collections, this will always return @code{(0 . (length |
| 983 | @var{suffix}))}. But more complex completion such as completion on | 983 | @var{suffix}))}. But more complex completion, such as completion on |
| 984 | files is done one field at a time. For example, completion of | 984 | files, is done one field at a time. For example, completion of |
| 985 | @code{"/usr/sh"} will include @code{"/usr/share/"} but not | 985 | @code{"/usr/sh"} will include @code{"/usr/share/"} but not |
| 986 | @code{"/usr/share/doc"} even if @code{"/usr/share/doc"} exists. | 986 | @code{"/usr/share/doc"} even if @code{"/usr/share/doc"} exists. |
| 987 | Also @code{all-completions} on @code{"/usr/sh"} will not include | 987 | Also @code{all-completions} on @code{"/usr/sh"} will not include |
| 988 | @code{"/usr/share/"} but only @code{"share/"}. So if @var{string} is | 988 | @code{"/usr/share/"} but only @code{"share/"}. So if @var{string} is |
| 989 | @code{"/usr/sh"} and @var{suffix} is @code{"e/doc"}, | 989 | @code{"/usr/sh"} and @var{suffix} is @code{"e/doc"}, |
| 990 | @code{completion-boundaries} will return @code{(5 . 1)} which tells us | 990 | @code{completion-boundaries} will return @w{@code{(5 . 1)}} which tells us |
| 991 | that the @var{collection} will only return completion information that | 991 | that the @var{collection} will only return completion information that |
| 992 | pertains to the area after @code{"/usr/"} and before @code{"/doc"}. | 992 | pertains to the area after @code{"/usr/"} and before @code{"/doc"}. |
| 993 | @code{try-completion} is not affected by nontrivial boundaries; i.e., | 993 | @code{try-completion} is not affected by nontrivial boundaries; e.g., |
| 994 | @code{try-completion} on @code{"/usr/sh"} might still return | 994 | @code{try-completion} on @code{"/usr/sh"} might still return |
| 995 | @code{"/usr/share/"}, not @code{"share/"}. | 995 | @code{"/usr/share/"}, not @code{"share/"}. |
| 996 | @end defun | 996 | @end defun |
| @@ -1897,11 +1897,11 @@ should return @code{(boundaries @var{start} . @var{end})}, where | |||
| 1897 | string, and @var{end} is the position of the end boundary in | 1897 | string, and @var{end} is the position of the end boundary in |
| 1898 | @var{suffix}. | 1898 | @var{suffix}. |
| 1899 | 1899 | ||
| 1900 | If you return nontrivial boundaries, make sure that the | 1900 | If a Lisp program returns nontrivial boundaries, it should make sure that the |
| 1901 | @code{all-completions} operation is consistent with them. The | 1901 | @code{all-completions} operation is consistent with them. The |
| 1902 | completions returned by @code{all-completions} should only pertain to | 1902 | completions returned by @code{all-completions} should only pertain to |
| 1903 | the piece of the prefix and suffix covered by the completion | 1903 | the piece of the prefix and suffix covered by the completion |
| 1904 | boundaries. @ref{Basic Completion} for the precise expected semantics | 1904 | boundaries. @xref{Basic Completion}, for the precise expected semantics |
| 1905 | of completion boundaries. | 1905 | of completion boundaries. |
| 1906 | 1906 | ||
| 1907 | @item metadata | 1907 | @item metadata |