aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2021-04-23 16:32:37 +0300
committerEli Zaretskii2021-04-23 16:32:37 +0300
commite44a0b7c79e20cd1841bd59f7a2c2a0698a1a3cd (patch)
tree33494f8345cfcdc45d6944c67945ba18ea8d4947
parent87e5cc2ccbe3423640cd95d60f0b588d9d2bd029 (diff)
downloademacs-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.texi12
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
981Normally completion operates on the whole string, so for all normal 981Normally completion operates on the whole string, so for all normal
982collections, this will always return @code{(0 . (length 982collections, 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
984files is done one field at a time. For example, completion of 984files, 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.
987Also @code{all-completions} on @code{"/usr/sh"} will not include 987Also @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
991that the @var{collection} will only return completion information that 991that the @var{collection} will only return completion information that
992pertains to the area after @code{"/usr/"} and before @code{"/doc"}. 992pertains 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
1897string, and @var{end} is the position of the end boundary in 1897string, and @var{end} is the position of the end boundary in
1898@var{suffix}. 1898@var{suffix}.
1899 1899
1900If you return nontrivial boundaries, make sure that the 1900If 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
1902completions returned by @code{all-completions} should only pertain to 1902completions returned by @code{all-completions} should only pertain to
1903the piece of the prefix and suffix covered by the completion 1903the piece of the prefix and suffix covered by the completion
1904boundaries. @ref{Basic Completion} for the precise expected semantics 1904boundaries. @xref{Basic Completion}, for the precise expected semantics
1905of completion boundaries. 1905of completion boundaries.
1906 1906
1907@item metadata 1907@item metadata