From d2afeae40842d451342e3c6ed20daf319a1bba91 Mon Sep 17 00:00:00 2001 From: Jonas Bernoulli Date: Mon, 23 Feb 2026 10:45:52 +0100 Subject: manual: Reorder Accessibility Options node --- docs/transient.org | 40 ++++++++++++++++++++-------------------- docs/transient.texi | 40 ++++++++++++++++++++-------------------- lisp/transient.el | 30 +++++++++++++++--------------- 3 files changed, 55 insertions(+), 55 deletions(-) diff --git a/docs/transient.org b/docs/transient.org index f3279e1..2ba2616 100644 --- a/docs/transient.org +++ b/docs/transient.org @@ -682,10 +682,10 @@ don't hesitate to contact me. #+begin_src emacs-lisp (setopt transient-enable-menu-navigation 'verbose) ; the default - (setopt transient-select-menu-window t) - (setopt transient-force-single-column t) (setopt transient-navigate-to-group-descriptions t) (setopt transient-describe-menu t) + (setopt transient-select-menu-window t) + (setopt transient-force-single-column t) (add-hook 'transient-setup-buffer-hook 'ding) #+end_src @@ -697,24 +697,6 @@ text at point, to be run when a transient menu is active, for example: [my-read-text-at-point] #'transient--do-stay) #+end_src -- User Option: transient-select-menu-window :: - - This option controls whether the window displaying the transient menu - is automatically selected has soon as it is displayed. - - Enabling this is discouraged, except for users of braille output - devises. Note that enabling this, or alternatively selecting the - menu window on demand, are both unnecessary, to be able to move - the cursor in the menu. See ~transient-enable-menu-navigation~. - -- User Option: transient-force-single-column :: - - This option controls whether the use of a single column to display - suffixes is enforced. This might be useful for users with low - vision who use large text and might otherwise have to scroll in two - dimensions. This is also useful for blind users, because it causes - suffixes to be navigated in a more natural order. - - User Option: transient-navigate-to-group-descriptions :: This option controls whether menu navigation commands stop at group @@ -738,6 +720,24 @@ text at point, to be run when a transient menu is active, for example: docstring is used as fallback. If the value is ~docstring~, then the docstring is used even if a description is available. +- User Option: transient-select-menu-window :: + + This option controls whether the window displaying the transient menu + is automatically selected has soon as it is displayed. + + Enabling this is discouraged, except for users of braille output + devises. Note that enabling this, or alternatively selecting the + menu window on demand, are both unnecessary, to be able to move + the cursor in the menu. See ~transient-enable-menu-navigation~. + +- User Option: transient-force-single-column :: + + This option controls whether the use of a single column to display + suffixes is enforced. This might be useful for users with low + vision who use large text and might otherwise have to scroll in two + dimensions. This is also useful for blind users, because it causes + suffixes to be navigated in a more natural order. + *** Auxiliary Options :PROPERTIES: :UNNUMBERED: notoc diff --git a/docs/transient.texi b/docs/transient.texi index b623453..22fef62 100644 --- a/docs/transient.texi +++ b/docs/transient.texi @@ -837,10 +837,10 @@ don't hesitate to contact me. @lisp (setopt transient-enable-menu-navigation 'verbose) ; the default -(setopt transient-select-menu-window t) -(setopt transient-force-single-column t) (setopt transient-navigate-to-group-descriptions t) (setopt transient-describe-menu t) +(setopt transient-select-menu-window t) +(setopt transient-force-single-column t) (add-hook 'transient-setup-buffer-hook 'ding) @end lisp @@ -852,24 +852,6 @@ text at point, to be run when a transient menu is active, for example: [my-read-text-at-point] #'transient--do-stay) @end lisp -@defopt transient-select-menu-window -This option controls whether the window displaying the transient menu -is automatically selected has soon as it is displayed. - -Enabling this is discouraged, except for users of braille output -devises. Note that enabling this, or alternatively selecting the -menu window on demand, are both unnecessary, to be able to move -the cursor in the menu. See @code{transient-enable-menu-navigation}. -@end defopt - -@defopt transient-force-single-column -This option controls whether the use of a single column to display -suffixes is enforced. This might be useful for users with low -vision who use large text and might otherwise have to scroll in two -dimensions. This is also useful for blind users, because it causes -suffixes to be navigated in a more natural order. -@end defopt - @defopt transient-navigate-to-group-descriptions This option controls whether menu navigation commands stop at group descriptions. @@ -893,6 +875,24 @@ docstring is used as fallback. If the value is @code{docstring}, then the docstring is used even if a description is available. @end defopt +@defopt transient-select-menu-window +This option controls whether the window displaying the transient menu +is automatically selected has soon as it is displayed. + +Enabling this is discouraged, except for users of braille output +devises. Note that enabling this, or alternatively selecting the +menu window on demand, are both unnecessary, to be able to move +the cursor in the menu. See @code{transient-enable-menu-navigation}. +@end defopt + +@defopt transient-force-single-column +This option controls whether the use of a single column to display +suffixes is enforced. This might be useful for users with low +vision who use large text and might otherwise have to scroll in two +dimensions. This is also useful for blind users, because it causes +suffixes to be navigated in a more natural order. +@end defopt + @anchor{Auxiliary Options} @subheading Auxiliary Options diff --git a/lisp/transient.el b/lisp/transient.el index 22b8dac..e9daba5 100644 --- a/lisp/transient.el +++ b/lisp/transient.el @@ -210,6 +210,21 @@ is useful for blind users, who use a braille or audio output device." :group 'transient :type 'boolean) +(defcustom transient-describe-menu nil + "Whether to begin the menu buffer with a very short description. + +When this is non-nil, then the menu buffer begins with a short +description. Ideally this is a string written exactly for that +purpose, but because this is a new feature, most menu commands +do not provide that yet. In that case the first line of its +docstring is used as fallback. If the value is `docstring', +then the docstring is used even if a description is available." + :package-version '(transient . "0.13.0") + :group 'transient + :type '(choice (const :tag "Insert description" t) + (const :tag "Insert docstring summary" docstring) + (const :tag "Do not insert description" nil))) + (defcustom transient-select-menu-window nil "Whether to select the window displaying the transient menu. @@ -529,21 +544,6 @@ in a more natural order." :group 'transient :type 'boolean) -(defcustom transient-describe-menu nil - "Whether to begin the menu buffer with a very short description. - -When this is non-nil, then the menu buffer begins with a short -description. Ideally this is a string written exactly for that -purpose, but because this is a new feature, most menu commands -do not provide that yet. In that case the first line of its -docstring is used as fallback. If the value is `docstring', -then the docstring is used even if a description is available." - :package-version '(transient . "0.13.0") - :group 'transient - :type '(choice (const :tag "Insert description" t) - (const :tag "Insert docstring summary" docstring) - (const :tag "Do not insert description" nil))) - (defconst transient--max-level 7) (defconst transient--default-child-level 1) (defconst transient--default-prefix-level 4) -- cgit v1.0