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

Improve documentation of dabbrevs

Browse source 
* lisp/dabbrev.el (dabbrev-expand): Doc fix.  (Bug#24890)

* doc/emacs/abbrevs.texi (Dynamic Abbrevs): Mention
'dabbrev-check-all-buffers', 'dabbrev-check-other-buffers', and
'dabbrev-ignored-buffer-names' and their purpose.  (Bug#24890)
This commit is contained in:
Eli Zaretskii 2016-11-07 19:34:51 +02:00
parent 7272e5db22
commit 4f478ca04b
2 changed files with 15 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

17
doc/emacs/abbrevs.texi
View file

@ -341,7 +341,7 @@ abbrev expansion happens only when you request it explicitly.
@table @kbd @table @kbd
@item M-/ @item M-/
Expand the word in the buffer before point as a @dfn{dynamic abbrev}, Expand the word in the buffer before point as a @dfn{dynamic abbrev},
by searching in the buffer for words starting with that abbreviation by searching for words starting with that abbreviation
(@code{dabbrev-expand}). (@code{dabbrev-expand}).
@item C-M-/ @item C-M-/
@ -361,14 +361,19 @@ The variable @code{dabbrev-limit}, if non-@code{nil}, specifies how far
away in the buffer to search for an expansion. away in the buffer to search for an expansion.
@vindex dabbrev-check-all-buffers @vindex dabbrev-check-all-buffers
@vindex dabbrev-check-other-buffers
After scanning the current buffer, @kbd{M-/} normally searches other After scanning the current buffer, @kbd{M-/} normally searches other
buffers, unless you have set @code{dabbrev-check-all-buffers} to buffers. The variables @code{dabbrev-check-all-buffers} and
@code{nil}. @code{dabbrev-check-other-buffers} can be used to determine which
other buffers, if any, are searched.
@vindex dabbrev-ignored-buffer-names
@vindex dabbrev-ignored-buffer-regexps @vindex dabbrev-ignored-buffer-regexps
For finer control over which buffers to scan, customize the variable For finer control over which buffers to scan, customize the
@code{dabbrev-ignored-buffer-regexps}. Its value is a list of regular variables @code{dabbrev-ignored-buffer-names} and
expressions. If a buffer's name matches any of these regular @code{dabbrev-ignored-buffer-regexps}. The value of the former is a
list of buffer names to skip. The value of the latter is a list of
regular expressions; if a buffer's name matches any of these regular
expressions, dynamic abbrev expansion skips that buffer. expressions, dynamic abbrev expansion skips that buffer.
A negative argument to @kbd{M-/}, as in @kbd{C-u - M-/}, says to A negative argument to @kbd{M-/}, as in @kbd{C-u - M-/}, says to

5
lisp/dabbrev.el
View file

@ -433,7 +433,10 @@ Expands to the most recent, preceding word for which this is a prefix.
If no suitable preceding word is found, words following point are If no suitable preceding word is found, words following point are
considered. If still no suitable word is found, then look in the considered. If still no suitable word is found, then look in the
buffers accepted by the function pointed out by variable buffers accepted by the function pointed out by variable
`dabbrev-friend-buffer-function'. `dabbrev-friend-buffer-function', if `dabbrev-check-other-buffers'
says so. Then, if `dabbrev-check-all-buffers' is non-nil, look in
all the other buffers, subject to constraints specified
by `dabbrev-ignored-buffer-names' and `dabbrev-ignored-regexps'.
A positive prefix argument, N, says to take the Nth backward *distinct* A positive prefix argument, N, says to take the Nth backward *distinct*
possibility. A negative argument says search forward. possibility. A negative argument says search forward.