manual: Document in transient-show-common-commands "Essential Options"

Keep the existing description in "Common Suffix Commands".

2 files changed, 22 insertions, 0 deletions

diff --git a/docs/transient.org b/docs/transient.org
index e2ad6f0..26ff5fa 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 5e61d13..b9331ec 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.