about summary refs log tree commit diff stats
path: root/doc/cha-config.5
diff options
context:
space:
mode:
authorbptato <nincsnevem662@gmail.com>2024-12-11 18:37:26 +0100
committerbptato <nincsnevem662@gmail.com>2024-12-11 19:40:26 +0100
commitd4c40ab5c1c1fe2df49f54d61632c1c979e63514 (patch)
treee1fcdc92d4559884c6bb22cf4d7c4b48d0e25039 /doc/cha-config.5
parentf2454bf6ecd79f454c54b5ccd2cdcc513d232c4b (diff)
downloadchawan-d4c40ab5c1c1fe2df49f54d61632c1c979e63514.tar.gz
pager, mailcap: misc fixes, add prompt for global mailcap
In the past, Chawan would read global mailcap (/etc/mailcap, ...) too,
but every now and then that would run entries that I didn't even know
existed and definitely didn't intend to run.  So I changed it to only
use ~/.mailcap, but this meant users now had to add mailcap entries for
every single mime type.

At some point I also changed application/octet-stream to always save to
disk, which is usually nice except when a text file is misrecognized as
binary.  Often times I just want to decide myself what to do.

So now there are two layers.  First, the global mailcap files (path as
per RFC) prompt before executing.  Then there is ~/.chawan/auto.mailcap
(or ~/.config/chawan/auto.mailcap) which runs entries automatically.

If you press shift before selecting an option in the prompt, the
corresponding entry gets copied to auto.mailcap.  It's also possible to
type a new entry on the fly.  Overall I think it's quite convenient.

One unfortunate side effect is that existing users will have to migrate
their entries to auto.mailcap, or redefine external.auto-mailcap to e.g.
~/.mailcap, but this seems acceptable.
Diffstat (limited to 'doc/cha-config.5')
-rw-r--r--doc/cha-config.59
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/cha-config.5 b/doc/cha-config.5
index 101c11e6..e22ee754 100644
--- a/doc/cha-config.5
+++ b/doc/cha-config.5
@@ -350,6 +350,15 @@ Search path for mime.types files.
 T}@T{
 T}
 T{
+auto\-mailcap
+T}@T{
+path
+T}@T{
+Mailcap file for entries that are automatically executed.
+The \[lq]Open as\[rq] prompt also saves entries in this file.
+T}@T{
+T}
+T{
 cgi\-dir
 T}@T{
 array of paths