aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2023-01-08 20:44:22 +0100
committerRobin Jarry <robin@jarry.cc>2023-01-10 21:49:18 +0100
commit04303172d4f96b284e0c915ce4a7b87e1439bb87 (patch)
tree4dcadaeb7995ccee0b260f384b063d8144e37c4c /doc
parent21d8963928162e8a1fe62b39c87b3e4735b05dba (diff)
downloadaerc-04303172d4f96b284e0c915ce4a7b87e1439bb87.tar.gz
filters: install them in $PREFIX/libexec/aerc/filters
The filesystem hierarchy standard describes /usr/share as "Architecture-independent data". This folder is not intended for executable scripts and especially not for arch specific binary files (such as the wrap filter). Lintian reports an error with aerc 0.14.0: arch-dependent-file-in-usr-share [usr/share/aerc/filters/wrap] Which I had to fix by moving the filter into /usr/libexec. Install all filters into $PREFIX/libexec/aerc/filters and update the default SearchDirs to look them up in here as well. Link: https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch04s11.html Link: https://salsa.debian.org/go-team/packages/aerc/-/commit/a0ca00260ffd Signed-off-by: Robin Jarry <robin@jarry.cc> Acked-by: Moritz Poldrack <moritz@poldrack.dev>
Diffstat (limited to 'doc')
-rw-r--r--doc/aerc-config.5.scd7
-rw-r--r--doc/aerc-templates.7.scd4
2 files changed, 7 insertions, 4 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index 474c005b..410b40a3 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -606,8 +606,8 @@ filters need to be able to read from standard input. Many programs support
reading from stdin by putting _-_ instead of a path to a file. You can also
chain together multiple filters by piping with _|_.
-aerc ships with some default filters installed in the share directory (usually
-_/usr/share/aerc/filters_). Note that these may have additional dependencies
+aerc ships with some default filters installed in the libexec directory (usually
+_/usr/libexec/aerc/filters_). Note that these may have additional dependencies
that aerc does not have alone.
The filter commands are invoked with _sh -c command_. The following folders are
@@ -615,8 +615,11 @@ appended to the system *$PATH* to allow referencing filters from their name only
```
${XDG_CONFIG_HOME:-~/.config}/aerc/filters
+~/.local/libexec/aerc/filters
${XDG_DATA_HOME:-~/.local/share}/aerc/filters
+$PREFIX/libexec/aerc/filters
$PREFIX/share/aerc/filters
+/usr/libexec/aerc/filters
/usr/share/aerc/filters
```
diff --git a/doc/aerc-templates.7.scd b/doc/aerc-templates.7.scd
index 67d5c112..8e616188 100644
--- a/doc/aerc-templates.7.scd
+++ b/doc/aerc-templates.7.scd
@@ -214,7 +214,7 @@ aerc provides the following additional functions:
Execute external command, provide the second argument to its stdin.
```
- {{exec `/usr/local/share/aerc/filters/html` .OriginalText}}
+ {{exec `/usr/libexec/aerc/filters/html` .OriginalText}}
```
*.Local*
@@ -267,7 +267,7 @@ aerc provides the following additional functions:
Example: Automatic HTML parsing for text/html mime type messages
```
{{if eq .OriginalMIMEType "text/html"}}
- {{exec `/usr/local/share/aerc/filters/html` .OriginalText | wrap 72 | quote}}
+ {{exec `/usr/libexec/aerc/filters/html` .OriginalText | wrap 72 | quote}}
{{else}}
{{wrap 72 .OriginalText | quote}}
{{end}}