aboutsummaryrefslogtreecommitdiffstats
path: root/doc/aerc.1.scd
diff options
context:
space:
mode:
Diffstat (limited to 'doc/aerc.1.scd')
-rw-r--r--doc/aerc.1.scd17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd
index e51ae8d1..a48735d7 100644
--- a/doc/aerc.1.scd
+++ b/doc/aerc.1.scd
@@ -119,6 +119,23 @@ These commands work in any context.
*:pwd*
Displays aerc's current working directory in the status bar.
+*:send-keys* _<keystrokes>_
+ Send keystrokes to the currently visible terminal, if any. Can be used to
+ control embedded editors to save drafts or quit in a safe manner.
+
+ Here's an example of quiting a Vim-like editor:
+
+ *:send-keys* _<Esc>:wq!<Enter>_
+
+ Note: when used in _binds.conf_ (see *aerc-binds*(5)), angle brackets
+ need to be escaped in order to make their way to the command:
+
+ <C-q> = :send-keys \\<Esc\\>:wq!\\<Enter\\><Enter>
+
+ This way the _<Esc>_ and the first _<Enter>_ keystrokes are passed to
+ *:send-keys*, while the last _<Enter>_ keystroke is executed directly,
+ committing the *:send-keys* command's execution.
+
*:term* [_<command>..._]++
*:terminal*
Opens a new terminal tab with a shell running in the current working