branch: externals/transient
commit 6e7c07a7f6363195707b2eee478fc4626211d5d7
Author: Jonas Bernoulli <[email protected]>
Commit: Jonas Bernoulli <[email protected]>
manual: Update some FAQ
---
docs/transient.org | 27 ++++++++++++---------------
docs/transient.texi | 27 ++++++++++++---------------
2 files changed, 24 insertions(+), 30 deletions(-)
diff --git a/docs/transient.org b/docs/transient.org
index be5332b4f5..1916ce62aa 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -2844,20 +2844,17 @@ by passing ~:display-action~ to
~transient-define-prefix~.
:UNNUMBERED: notoc
:END:
-To be able to mark text in Transient's menu buffer using the mouse,
-you have to add the below binding. Note that for technical reasons,
-the region won't be visualized, while doing so. After you have quit
-the transient menu, you will be able to yank it in another buffer.
+You can select text in the menu buffer using the mouse, like in most
+other buffers, by clicking ~mouse-1~ and keeping it pressed while
+dragging.
-#+begin_src emacs-lisp
- (keymap-set transient-predicate-map
- "<mouse-set-region>"
- #'transient--do-stay)
-#+end_src
+(Before v0.13.0, the above required additional configuration and the
+region was not visualized while dragging. This isn't the case anymore,
+but explains why the following was once deemed necessary.)
-Copying the region while not seeing the region is a bit fiddly, so a
-dedicated command, ~transient-copy-menu-text~, was added. You have to
-add a binding for this command in ~transient-map~.
+Alternatively the command ~transient-copy-menu-text~ can be used to copy
+the complete content of the menu buffer. You have to add a binding
+for this command in ~transient-map~.
#+begin_src emacs-lisp
(keymap-set transient-map "C-c C-w" #'transient-copy-menu-text)
@@ -2869,9 +2866,9 @@ add a binding for this command in ~transient-map~.
:END:
If your package only supports Emacs 30, just prefix the definition
-with ~;;;###autoload~. If your package supports released versions of
-Emacs, you unfortunately have to use a long form autoload comment
-as described in [[info:elisp#Autoload]].
+with ~;;;###autoload~. If your package supports older Emacs releases,
+you unfortunately have to use a long-form autoload comment as
+described in [[info:elisp#Autoload]].
#+begin_src emacs-lisp
;;;###autoload (autoload 'magit-dispatch "magit" nil t)
diff --git a/docs/transient.texi b/docs/transient.texi
index 5a41ccbe14..ad52562a1d 100644
--- a/docs/transient.texi
+++ b/docs/transient.texi
@@ -3184,20 +3184,17 @@ by passing @code{:display-action} to
@code{transient-define-prefix}.
@anchor{How can I copy text from the menu buffer?}
@appendixsec How can I copy text from the menu buffer?
-To be able to mark text in Transient's menu buffer using the mouse,
-you have to add the below binding. Note that for technical reasons,
-the region won't be visualized, while doing so. After you have quit
-the transient menu, you will be able to yank it in another buffer.
+You can select text in the menu buffer using the mouse, like in most
+other buffers, by clicking @code{mouse-1} and keeping it pressed while
+dragging.
-@lisp
-(keymap-set transient-predicate-map
- "<mouse-set-region>"
- #'transient--do-stay)
-@end lisp
+(Before v0.13.0, the above required additional configuration and the
+region was not visualized while dragging. This isn't the case anymore,
+but explains why the following was once deemed necessary.)
-Copying the region while not seeing the region is a bit fiddly, so a
-dedicated command, @code{transient-copy-menu-text}, was added. You have to
-add a binding for this command in @code{transient-map}.
+Alternatively the command @code{transient-copy-menu-text} can be used to copy
+the complete content of the menu buffer. You have to add a binding
+for this command in @code{transient-map}.
@lisp
(keymap-set transient-map "C-c C-w" #'transient-copy-menu-text)
@@ -3207,9 +3204,9 @@ add a binding for this command in @code{transient-map}.
@appendixsec How can I autoload prefix and suffix commands?
If your package only supports Emacs 30, just prefix the definition
-with @code{;;;###autoload}. If your package supports released versions of
-Emacs, you unfortunately have to use a long form autoload comment
-as described in @ref{Autoload,,,elisp,}.
+with @code{;;;###autoload}. If your package supports older Emacs releases,
+you unfortunately have to use a long-form autoload comment as
+described in @ref{Autoload,,,elisp,}.
@lisp
;;;###autoload (autoload 'magit-dispatch "magit" nil t)
