branch: externals/transient
commit 44792c2bf91e5e1b72b854ebafc220ac6ac89b74
Author: Jonas Bernoulli <[email protected]>
Commit: Jonas Bernoulli <[email protected]>
manual: Copy-edit
---
docs/transient.org | 20 ++++++++++----------
docs/transient.texi | 20 ++++++++++----------
2 files changed, 20 insertions(+), 20 deletions(-)
diff --git a/docs/transient.org b/docs/transient.org
index 8b13efb4fc..d2d83a61c7 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -114,18 +114,18 @@ looks a bit like this:
This is a simplified version of ~magit-tag~. Info manuals do not
support images or colored text, so the above “screenshot” lacks some
information; in practice you would be able to tell whether the
-arguments ~--force~ and ~--annotate~ are enabled or not based on their
+arguments ~--force~ and ~--annotate~ are enabled or not, based on their
color.
#+end_quote
#+cindex: command dispatchers
Transient can be used to implement simple “command dispatchers”. The
main benefit then is that the user can see all the available commands
-in a popup buffer. That is useful by itself because it frees the user
-from having to remember all the keys that are valid after a certain
-prefix key or command. Magit's ~magit-dispatch~ (on {{{kbd(C-x M-g)}}})
command is
-an example of using Transient to merely implement a command
-dispatcher.
+in a popup buffer, which can be thought of as a “menus”. That is
+useful by itself because it frees the user from having to remember all
+the keys that are valid after a certain prefix key or command.
+Magit's ~magit-dispatch~ (on {{{kbd(C-x M-g)}}}) command is an example of using
+Transient to merely implement a command dispatcher.
In addition to that, Transient also allows users to interactively pass
arguments to commands. These arguments can be much more complex than
@@ -2013,10 +2013,10 @@ Yes, see ~transient-display-buffer-action~ in
[[*Configuration]].
:UNNUMBERED: notoc
:END:
-To be able to mark text in any transient popup buffer using the mouse,
-you have to add the following binding. Note that the region won't be
-visualized, while doing so. After you have quit the transient popup,
-you will be able to yank it another buffer.
+To be able to mark text in Transient's popup 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 popup, you will be able to yank it in another buffer.
#+begin_src emacs-lisp
(keymap-set transient-predicate-map
diff --git a/docs/transient.texi b/docs/transient.texi
index 3fae6438fa..1e280ff8c5 100644
--- a/docs/transient.texi
+++ b/docs/transient.texi
@@ -213,7 +213,7 @@ looks a bit like this:
This is a simplified version of @code{magit-tag}. Info manuals do not
support images or colored text, so the above ``screenshot'' lacks some
information; in practice you would be able to tell whether the
-arguments @code{--force} and @code{--annotate} are enabled or not based on
their
+arguments @code{--force} and @code{--annotate} are enabled or not, based on
their
color.
@end quotation
@@ -221,11 +221,11 @@ color.
@cindex command dispatchers
Transient can be used to implement simple ``command dispatchers''. The
main benefit then is that the user can see all the available commands
-in a popup buffer. That is useful by itself because it frees the user
-from having to remember all the keys that are valid after a certain
-prefix key or command. Magit's @code{magit-dispatch} (on @kbd{C-x M-g})
command is
-an example of using Transient to merely implement a command
-dispatcher.
+in a popup buffer, which can be thought of as a ``menus''. That is
+useful by itself because it frees the user from having to remember all
+the keys that are valid after a certain prefix key or command.
+Magit's @code{magit-dispatch} (on @kbd{C-x M-g}) command is an example of using
+Transient to merely implement a command dispatcher.
In addition to that, Transient also allows users to interactively pass
arguments to commands. These arguments can be much more complex than
@@ -2297,10 +2297,10 @@ Yes, see @code{transient-display-buffer-action} in
@ref{Configuration}.
@anchor{How can I copy text from the popup buffer?}
@appendixsec How can I copy text from the popup buffer?
-To be able to mark text in any transient popup buffer using the mouse,
-you have to add the following binding. Note that the region won't be
-visualized, while doing so. After you have quit the transient popup,
-you will be able to yank it another buffer.
+To be able to mark text in Transient's popup 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 popup, you will be able to yank it in another buffer.
@lisp
(keymap-set transient-predicate-map
