[elpa] externals/embark 5e86f50825: Add some commentary on recommend key bindings (fix #493)

[ELPA Syncer]

branch: externals/embark
commit 5e86f50825469a6ef00d7a3c6d6f59af5b759495
Author: Omar Antolín <omar.antolin@gmail.com>
Commit: Omar Antolín <omar.antolin@gmail.com>

    Add some commentary on recommend key bindings (fix #493)
---
 README.org  | 18 ++++++++++++++++++
 embark.texi | 23 +++++++++++++++++++++++
 2 files changed, 41 insertions(+)

diff --git a/README.org b/README.org
index 9e17aed49c..84c4fbdf84 100644
--- a/README.org
+++ b/README.org
@@ -285,6 +285,24 @@ starting configuration:
     (embark-collect-mode . consult-preview-at-point-mode))
 #+end_src
 
+About the suggested key bindings for =embark-act= and =embark-dwim=:
+- Those key bindings are unlikely to work in the terminal, but
+  terminal users are probably well aware of this and will know to
+  select different bindings.
+- The suggested =C-.= binding is used by default in (at least some
+  installations of) GNOME to input emojis, and Emacs doesn't even get
+  a chance to respond to the binding. You can select a different key
+  binding for =embark-act= or use =ibus-setup= to change the shortcut for
+  emoji insertion (Emacs uses =C-x 8 e e=, in case you want to set the
+  same one system-wide).
+- The suggested alternative of =M-.= for =embark-dwim= is bound by default
+  to =xref-find-definitions=. That is a very useful command but
+  overwriting it with =embark-dwim= is sensible since in Embark's
+  default configuration, =embark-dwim= will also find the definition of
+  the identifier at point. (Note that =xref-find-definitions= with a
+  prefix argument prompts you for an identifier, =embark-dwim= does not
+  cover this case).
+
 Other Embark commands such as =embark-act-all=, =embark-become=,
 =embark-collect=, and =embark-export= can be run through =embark-act= as
 actions bound to =A=, =B=, =S= (for "snapshot"), and =E= respectively, and
diff --git a/embark.texi b/embark.texi
index a222a5d844..08681d76cd 100644
--- a/embark.texi
+++ b/embark.texi
@@ -382,6 +382,29 @@ starting configuration:
   (embark-collect-mode . consult-preview-at-point-mode))
 @end lisp
 
+About the suggested key bindings for @samp{embark-act} and @samp{embark-dwim}:
+@itemize
+@item
+Those key bindings are unlikely to work in the terminal, but
+terminal users are probably well aware of this and will know to
+select different bindings.
+@item
+The suggested @samp{C-.} binding is used by default in (at least some
+installations of) GNOME to input emojis, and Emacs doesn't even get
+a chance to respond to the binding. You can select a different key
+binding for @samp{embark-act} or use @samp{ibus-setup} to change the shortcut 
for
+emoji insertion (Emacs uses @samp{C-x 8 e e}, in case you want to set the
+same one system-wide).
+@item
+The suggested alternative of @samp{M-.} for @samp{embark-dwim} is bound by 
default
+to @samp{xref-find-definitions}. That is a very useful command but
+overwriting it with @samp{embark-dwim} is sensible since in Embark's
+default configuration, @samp{embark-dwim} will also find the definition of
+the identifier at point. (Note that @samp{xref-find-definitions} with a
+prefix argument prompts you for an identifier, @samp{embark-dwim} does not
+cover this case).
+@end itemize
+
 Other Embark commands such as @samp{embark-act-all}, @samp{embark-become},
 @samp{embark-collect}, and @samp{embark-export} can be run through 
@samp{embark-act} as
 actions bound to @samp{A}, @samp{B}, @samp{S} (for ``snapshot''), and @samp{E} 
respectively, and