summary refs log tree commit diff
diff options
context:
space:
mode:
authorLeah Neukirchen <leah@vuxu.org>2018-01-07 23:00:06 +0100
committerLeah Neukirchen <leah@vuxu.org>2018-01-07 23:00:06 +0100
commitcb33213374aee70e755df8f0b9a6434d4a11b6a2 (patch)
treec5bcfb2a9955b648d06d604d42ab293bfa5f92a9
parentdd6915d47e265076e55d993c134c55fccf134ca3 (diff)
downloadmblaze-cb33213374aee70e755df8f0b9a6434d4a11b6a2.tar.gz
mblaze-cb33213374aee70e755df8f0b9a6434d4a11b6a2.tar.xz
mblaze-cb33213374aee70e755df8f0b9a6434d4a11b6a2.zip
mshow.1: explain filter exit statuses
-rw-r--r--man/mshow.119
1 files changed, 19 insertions, 0 deletions
diff --git a/man/mshow.1 b/man/mshow.1
index dbb0d9d..b33b889 100644
--- a/man/mshow.1
+++ b/man/mshow.1
@@ -125,6 +125,25 @@ The environment variable
 .Ev PIPE_CHARSET
 will be set to the charset declared in the MIME part,
 if known.
+.Pp
+Filters can communicate with
+.Nm
+using their exit status:
+.Bl -tag -compact -width 8n
+.It 0
+The output is printed as plain text.
+.It 62
+The output is printed raw, without escaping.
+.It 63
+Behave as if the filter never ran.
+.It 64
+The output is a RFC5322 message that should be rendered again.
+.It 65 to 80
+Render the
+.Va n Ns \&- Ns 64th
+part of this text/multipart part.
+.El
+All other exit statuses are regarded as errors.
 .Sh ENVIRONMENT
 .Bl -tag -width MBLAZE_NOCOLOR
 .It Ev MBLAZE_PAGER