diff options
| author | Jason Cox <me@jasoncarloscox.com> | 2024-02-15 15:35:25 -0500 |
|---|---|---|
| committer | Robin Jarry <robin@jarry.cc> | 2024-02-19 20:37:37 +0100 |
| commit | 673ae1bbc760ad96664e84d54d373839d9ae2c57 (patch) | |
| tree | 7438bdebf466c61724b54196ca0adbef157b94c4 /doc/aerc.1.scd | |
| parent | 5781f1e6b49025e2909c4b87912d6c9dd7256286 (diff) | |
| download | aerc-673ae1bbc760ad96664e84d54d373839d9ae2c57.tar.gz | |
ipc: accept verbatim commands
When aerc receives a command over IPC, it quotes the arguments before
passing them on to the internal command parser. In many cases, the
parser interprets the quotes, and the command runs with the arguments
exactly as they were specified in the shell. In some cases, though, the
quotes are not interpreted and the additional quotes can cause the
command to fail. Simply eliminating the addition of quotes is not
possible because some commands need them.
Allow a command and its arguments to be specified as a single argument
in the shell. In that case, pass that argument verbatim to the internal
command parser so that it is interpreted exactly as if it had been typed
directly in aerc's command line.
Link: https://lists.sr.ht/~rjarry/aerc-devel/%3C20240203085541.27416-2-contact%40willowbarraco.fr%3E
Changelog-added: Execute IPC commands verbatim by providing the
command and its args as a single argument in the shell.
Cc: Willow Barraco <contact@willowbarraco.fr>
Signed-off-by: Jason Cox <me@jasoncarloscox.com>
Acked-by: Robin Jarry <robin@jarry.cc>
Diffstat (limited to 'doc/aerc.1.scd')
| -rw-r--r-- | doc/aerc.1.scd | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd index e4a3305f..91e75d60 100644 --- a/doc/aerc.1.scd +++ b/doc/aerc.1.scd @@ -66,6 +66,15 @@ from your terminal. Run an aerc-internal command as you would in Ex-Mode. See *RUNTIME COMMANDS* below. + The command to be executed and its arguments can either be passed as + separate arguments in the shell (e.g., _aerc :cmd arg1 arg2_) or as a single + argument in the shell (e.g., _aerc ":cmd arg1 arg2"_). In the former case, + aerc may add quotes to the command before it is parsed in an attempt to + preserve arguments containing spaces and other special characters. In the + latter case, aerc will parse the command verbatim, as if it had been typed + directly on aerc's command line. This latter form can be helpful for + commands that don't interpret quotes in their arguments. + *mbox:*_<file>_ Open the specified mbox file as a virtual temporary account. |