add maddr: show mail addresses in messages

1 files changed, 60 insertions, 0 deletions

diff --git a/man/maddr.1 b/man/maddr.1
new file mode 100644
index 0000000..71dd41d
--- /dev/null
+++ b/man/maddr.1
@@ -0,0 +1,60 @@
+.Dd July 22, 2016
+.Dt MADDR 1
+.Os
+.Sh NAME
+.Nm maddr
+.Nd show mail addresses in messages
+.Sh SYNOPSIS
+.Nm
+.Op Fl h Ar headers
+.Op Ar msgs\ ...
+.Sh DESCRIPTION
+.Nm
+prints all mail addresses mentioned in the
+.Ar headers
+of the given
+.Ar msgs ,
+line by line.
+See
+.Xr mmsg 7
+for the message argument syntax.
+.Pp
+If no
+.Ar msgs
+are passed,
+and
+.Nm
+is used interactively,
+.Nm
+will default to the current sequence.
+Else,
+.Nm
+will read filenames from standard input.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl h Ar headers
+Only search the colon-seperated list of
+.Ar headers
+for mail addresses.
+Default:
+.Sq Li from:sender:reply-to:to:cc:bcc:
+and the same with
+.Sq Li resent- .
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Xr mmsg 7
+.Sh AUTHORS
+.An Christian Neukirchen Aq Mt chneukirchen@gmail.com
+.Sh LICENSE
+.Nm
+is in the public domain.
+.Pp
+To the extent possible under law,
+the creator of this work
+has waived all copyright and related or
+neighboring rights to this work.
+.Pp
+.Lk http://creativecommons.org/publicdomain/zero/1.0/