diff options
Diffstat (limited to 'docs/transient.org')
| -rw-r--r-- | docs/transient.org | 24 |
1 files changed, 18 insertions, 6 deletions
diff --git a/docs/transient.org b/docs/transient.org index 7da7e72..be5332b 100644 --- a/docs/transient.org +++ b/docs/transient.org @@ -600,14 +600,21 @@ Two more essential options are documented in [[* Common Suffix Commands]]. - User Option: transient-enable-menu-navigation :: This option controls whether navigation commands are enabled in - transient's menu buffer. If the value is ~verbose~ (the default), - brief documentation about the command under point is additionally - show in the echo area. + transient menu buffer, and whether additional documentation is shown + in the echo area while doing so. + + If the value is ~verbose~ (the default), additional documentation + about the command at point is shown in the echo area. If this would + result in the same documentation, which is being displayed inside + the menu buffer, to be duplicated in the echo area, then ~verbose~ + forgoes doing so. Use ~force-verbose~ to echo even such documentation. + Use ~t~ to enable menu navigation without showing documentation in the + echo area. While a transient is active, the menu buffer is (by default) not the current buffer, making it necessary to use dedicated commands to act - on that buffer itself. If this option is non-nil, then the following - bindings are available: + on that buffer itself. If this option is non-nil, then the + following bindings are available: - {{{kbd(UP)}}} moves the cursor to the previous suffix. - {{{kbd(DOWN)}}} moves the cursor to the next suffix. @@ -700,7 +707,12 @@ text at point, to be run when a transient menu is active, for example: - User Option: transient-enable-menu-navigation :: This option is documented in the previous node ([[* Essential - Options]]). + Options]]). You might want to change the value from ~verbose~ to + ~force-verbose~, which causes information to be shown in the echo + area, even if it is identical to information already displayed in + the menu buffer. Whether that is useful to you depends on whether + your setup makes it easy to read the last message displayed in the + echo area. - User Option: transient-navigate-to-group-descriptions :: |