diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index b70dba2b1b0..2de147a204c 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -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, diff --git a/etc/NEWS b/etc/NEWS index 34171585524..667fc9bda74 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -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 --