terminal: add `:send-keys` command

Add a new command for sending keystrokes to the active terminal, if
there is one visible. Covers split preview, message viewer, composer and
the terminal mode.

This can be used to navigate the embedded applications to scroll or
safely quit them when needed.

Signed-off-by: Vitaly Ovchinnikov <v@postbox.nz>
Acked-by: Robin Jarry <robin@jarry.cc>

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