diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/aerc-config.5.scd | 19 | ||||
| -rw-r--r-- | doc/aerc.1.scd | 14 |
2 files changed, 31 insertions, 2 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index d6b56fa0..8b7aa55c 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -508,6 +508,25 @@ that aerc does not have alone. Note that said email body is converted into UTF-8 before being passed to filters. +## OPENERS + +Openers allow you to specify the command to use for the *:open* action on a +per-MIME-type basis. They are configured in the *[openers]* section of +aerc.conf. + +*{}* is expanded as the temporary filename to be opened. If it is not +encountered in the command, the temporary filename will be appened to the end +of the command. Environment variables are also expanded. Tilde is not expanded. + +Example: + +``` +[openers] +text/html=surf -dfgms +text/plain=gvim {} +125 +message/rfc822=thunderbird +``` + ## TRIGGERS Triggers specify commands to execute when certain events occur. diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd index 38862a53..355a08d6 100644 --- a/doc/aerc.1.scd +++ b/doc/aerc.1.scd @@ -392,8 +392,18 @@ message list, the message in the message viewer, etc). at the bottom of the message viewer. *open* [args...] - Saves the current message part in a temporary file and opens it - with the system handler. Any given args are forwarded to the open handler + Saves the current message part to a temporary file, then opens it. If no + arguments are provided, it will open the current MIME part with the + matching command in the *[openers]* section of _aerc.conf_. When no match + is found in *[openers]*, it falls back to the default system handler. + + When arguments are provided: + + - The first argument must be the program to open the message part with. + Subsequent args are passed to that program. + - *{}* will be expanded as the temporary filename to be opened. If it is + not encountered in the arguments, the temporary filename will be + appened to the end of the command. *save* [-fpa] <path> Saves the current message part to the given path. |