Improve documentation of 'list-abbrevs'

* doc/emacs/abbrevs.texi (Editing Abbrevs): Describe how system
abbrevs are shown by 'list-abbrevs'.  Suggested by Shynur Xie
<one.last.kiss@outlook.com>.  (Bug#65907)
This commit is contained in:
Eli Zaretskii 2023-09-13 17:23:03 +03:00
parent 5dcc4b7eab
commit a65d1a5a16

View file

@ -275,6 +275,8 @@ Edit a list of abbrevs; you can add, alter or remove definitions.
@example @example
@var{various other tables@dots{}} @var{various other tables@dots{}}
(python-mode-skeleton-abbrev-table)
"class" (sys) 0 "" python-skeleton-class
(lisp-mode-abbrev-table) (lisp-mode-abbrev-table)
"ks" 0 "keymap-set" "ks" 0 "keymap-set"
(global-abbrev-table) (global-abbrev-table)
@ -297,11 +299,14 @@ keeps track of this to help you see which abbrevs you actually use, so
that you can eliminate those that you don't use often. The string at that you can eliminate those that you don't use often. The string at
the end of the line is the expansion. the end of the line is the expansion.
Some abbrevs are marked with @samp{(sys)}. These @dfn{system abbrevs} Some abbrevs are marked with @samp{(sys)}. These @dfn{system
(@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) are abbrevs} (@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual})
pre-defined by various modes, and are not saved to your abbrev file. are pre-defined by various modes, and are not saved to your abbrev
To disable a system abbrev, define an abbrev of the same name that file. To disable a system abbrev, define an abbrev of the same name
expands to itself, and save it to your abbrev file. that expands to itself, and save it to your abbrev file. The system
abbrevs have an associated hook function, which is called to perform
the abbrev expansion; the name of that function follows the abbrev
expansion in the buffer shown by @code{list-abbrevs}.
@findex edit-abbrevs @findex edit-abbrevs
@kindex C-c C-c @r{(Edit Abbrevs)} @kindex C-c C-c @r{(Edit Abbrevs)}