[elpa] externals/transient 2f76ce107c 2/8: manual: Document in transient-show-common-commands "Essential Options"

[Jonas Bernoulli]

branch: externals/transient
commit 2f76ce107c6ef57e42db1dd773bf5ab932eaaea0
Author: Jonas Bernoulli <jonas@bernoul.li>
Commit: Jonas Bernoulli <jonas@bernoul.li>

    manual: Document in transient-show-common-commands "Essential Options"
    
    Keep the existing description in "Common Suffix Commands".
---
 docs/transient.org  | 11 +++++++++++
 docs/transient.texi | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/docs/transient.org b/docs/transient.org
index e2ad6f043a..26ff5fab62 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -458,6 +458,17 @@ Also see [[* Common Suffix Commands]].
     the popup is shown after that many seconds of inactivity (using
     the absolute value).
 
+- User Option: transient-show-common-commands ::
+
+  This option controls whether shared suffix commands are shown
+  alongside the transient-specific infix and suffix commands.  By
+  default, the shared commands are not shown to avoid overwhelming
+  the user with too many options.
+
+  While a transient is active, pressing {{{kbd(C-x)}}} always shows the common
+  commands.  The value of this option can be changed for the current
+  Emacs session by typing {{{kbd(C-x t)}}} while a transient is active.
+
 - User Option: transient-show-during-minibuffer-read ::
 
   This option controls whether the transient menu continues to be
diff --git a/docs/transient.texi b/docs/transient.texi
index 5e61d1375c..b9331ec63e 100644
--- a/docs/transient.texi
+++ b/docs/transient.texi
@@ -616,6 +616,17 @@ the absolute value).
 @end itemize
 @end defopt
 
+@defopt transient-show-common-commands
+This option controls whether shared suffix commands are shown
+alongside the transient-specific infix and suffix commands.  By
+default, the shared commands are not shown to avoid overwhelming
+the user with too many options.
+
+While a transient is active, pressing @kbd{C-x} always shows the common
+commands.  The value of this option can be changed for the current
+Emacs session by typing @kbd{C-x t} while a transient is active.
+@end defopt
+
 @defopt transient-show-during-minibuffer-read
 This option controls whether the transient menu continues to be
 displayed while the minibuffer is used to read user input.