aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2023-01-25 00:34:59 +0100
committerRobin Jarry <robin@jarry.cc>2023-01-26 00:21:14 +0100
commit63f0e0cbc9a5f072d8915717c89d7ab4f4ff94af (patch)
treeb1940dd2d2a07960786b35f51a7278b326a44179 /doc
parent402a634937573b86694b372cf76ce375df51f79d (diff)
downloadaerc-63f0e0cbc9a5f072d8915717c89d7ab4f4ff94af.tar.gz
viewer: allow piping full headers in a filter
Allow defining a .headers special filter command that will be used only to process email headers (when [viewer].show-headers=true). Signed-off-by: Robin Jarry <robin@jarry.cc> Tested-by: Kt Programs <ktprograms@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/aerc-config.5.scd11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index cc0a5f80..22c3a40a 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -644,6 +644,10 @@ The following variables are defined in the filter command environment:
Note that said email body is converted into UTF-8 before being passed to
filters.
+If *show-headers* is enabled, only the currently viewed part body is piped into
+the filter command. A special _.headers_ filter command can be defined to post
+process the full headers.
+
## EXAMPLES
_text/plain_
@@ -708,6 +712,13 @@ _text/\*_
text/\*=bat -fP --file-name="$AERC_FILENAME" --style=plain
```
+_.headers_
+ Colorize email headers when *show-headers* is _true_.
+
+ ```
+ .headers=colorize
+ ```
+
_message/delivery-status_
When not being able to deliver the provider might send such emails: