branch: externals/transient
commit d2afeae40842d451342e3c6ed20daf319a1bba91
Author: Jonas Bernoulli <[email protected]>
Commit: Jonas Bernoulli <[email protected]>
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 f3279e1caa..2ba2616257 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 b623453e92..22fef625ff 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 22b8dac6a6..e9daba5002 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)
