diff options
author | Eli Zaretskii <eliz@gnu.org> | 2017-01-13 11:12:27 +0200 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2017-01-13 11:12:27 +0200 |
commit | 42eae54207beb340ef2732c3d66e2e120a1c29f4 (patch) | |
tree | 08e39b38e5d0de2508ebb7c2ce11063ac0f17574 | |
parent | b0ade0df21d4cde8537c29f81eb10bdcf1cdfbfc (diff) | |
download | emacs-42eae54207beb340ef2732c3d66e2e120a1c29f4.tar.gz |
Improve documentation of dabbrevs
* doc/emacs/abbrevs.texi (Dynamic Abbrevs): Add a cross reference
to "Dabbrev Customization".
(Dabbrev Customization): More details about the default value of
dabbrev-abbrev-char-regexp and use cases when it might not be good
enough. (Bug#25432)
-rw-r--r-- | doc/emacs/abbrevs.texi | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/doc/emacs/abbrevs.texi b/doc/emacs/abbrevs.texi index 8cb7a4838e9..117d07e2814 100644 --- a/doc/emacs/abbrevs.texi +++ b/doc/emacs/abbrevs.texi @@ -388,6 +388,9 @@ words that follow the expansion in its original context. Simply type @kbd{@key{SPC} M-/} for each additional word you want to copy. The spacing and punctuation between words is copied along with the words. + You can control the way @kbd{M-/} determines the word to expand and +how to expand it, see @ref{Dabbrev Customization}. + The command @kbd{C-M-/} (@code{dabbrev-completion}) performs completion of a dynamic abbrev. Instead of trying the possible expansions one by one, it finds all of them, then inserts the text @@ -437,12 +440,17 @@ copies the expansion verbatim including its case pattern. @vindex dabbrev-abbrev-char-regexp The variable @code{dabbrev-abbrev-char-regexp}, if non-@code{nil}, -controls which characters are considered part of a word, for dynamic expansion -purposes. The regular expression must match just one character, never -two or more. The same regular expression also determines which -characters are part of an expansion. The (default) value @code{nil} -has a special meaning: dynamic abbrevs are made of word characters, -but expansions are made of word and symbol characters. +controls which characters are considered part of a word, for dynamic +expansion purposes. The regular expression must match just one +character, never two or more. The same regular expression also +determines which characters are part of an expansion. The (default) +value @code{nil} has a special meaning: dynamic abbrevs (i.e.@: the +word at point) are made of word characters, but their expansions are +looked for as sequences of word and symbol characters. This is +generally appropriate for expanding symbols in a program source and +also for human-readable text in many languages, but may not be what +you want in a text buffer that includes unusual punctuation characters; +in that case, the value @code{"\\sw"} might produce better results. @vindex dabbrev-abbrev-skip-leading-regexp In shell scripts and makefiles, a variable name is sometimes prefixed |