Github/emacs
2
0
Fork 1
mirror of git://git.sv.gnu.org/emacs.git synced 2026-06-14 12:31:25 +00:00
Code Issues Projects Releases Packages Wiki Activity

; Add missing documentation for new 'cus-edit' bindings

Browse source 
* doc/emacs/custom.texi (Changing a Variable):
* etc/NEWS: Mention them.
This commit is contained in:
Philip Kaludercic 2026-02-28 20:07:45 +01:00
parent 4d398ae00c
commit 6f337499e6
No known key found for this signature in database
2 changed files with 28 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

31
doc/emacs/custom.texi
View file

@ -193,18 +193,20 @@ the customization buffer:
Maximum length of kill ring before oldest elements are thrown away.
@end smallexample
The first line shows that the variable is named
@code{kill-ring-max}, formatted as @samp{Kill Ring Max} for easier
viewing, and also shows its expected type: a positive integer or zero.
The default value is @samp{120}. The button labeled @samp{[Hide]},
if activated, hides the variable's value and state; this is useful to
avoid cluttering up the customization buffer with very long values
(for this reason, variables that have very long values may start out
hidden). If you use the @samp{[Hide]} button, it changes to
@samp{[Show Value]}, which you can activate to reveal the value and
state. On a graphical display, the @samp{[Hide]} and @samp{[Show
Value]} buttons are replaced with graphical triangles pointing
downwards and rightwards respectively.
@findex Custom-goto-first-choice
@kindex C-x C-i @r{(customization buffer)}
The first line shows that the variable is named @code{kill-ring-max},
formatted as @samp{Kill Ring Max} for easier viewing, and also shows its
expected type: a positive integer or zero. The default value is
@samp{120}. You can move directly to the value with @kbd{C-x C-i}
(Custom-goto-first-choice). The button labeled @samp{[Hide]}, if
activated, hides the variable's value and state; this is useful to avoid
cluttering up the customization buffer with very long values (for this
reason, variables that have very long values may start out hidden). If
you use the @samp{[Hide]} button, it changes to @samp{[Show Value]},
which you can activate to reveal the value and state. On a graphical
display, the @samp{[Hide]} and @samp{[Show Value]} buttons are replaced
with graphical triangles pointing downwards and rightwards respectively.
The line after the variable name indicates the @dfn{customization
state} of the variable: in this example, @samp{STANDARD} means you
@ -347,12 +349,15 @@ does not appear if Emacs was started with the @option{-q} or
@kindex C-c C-c @r{(customization buffer)}
@kindex C-x C-c @r{(customization buffer)}
@kindex C-x C-k @r{(customization buffer)}
@findex Custom-set
@findex Custom-save
@findex Custom-reset-standard
The command @kbd{C-c C-c} (@code{Custom-set}) is equivalent to using
the @samp{[Set for Current Session]} button. The command @kbd{C-x
C-s} (@code{Custom-save}) is like using the @samp{[Save for Future
Sessions]} button.
Sessions]} button. Likewise, @kbd{C-c C-k} (@code{Custom-reset-standard})
is like using the @samp{[Revert...]} button.
@vindex custom-buffer-done-kill
The @samp{[Exit]} button switches out of the customization buffer,

10
etc/NEWS
View file

@ -3303,6 +3303,16 @@ functions defined later than the variable, as is common for minor modes.
This is intended for customizing directory-local variables in the
current directory's ".dir-locals.el" file.
+++
*** New keybinding 'C-c C-k' for 'Custom-reset-standard'
+++
*** New command 'Custom-goto-first-choice' (bound to 'C-c C-i')
When first opening the customization interface for a user option, you
can use this command as a shortcut to jump to the first actionable
button or field (for instance an on/off button for boolean options, or a
text field for other values).
** Pulse
--