Factor trim format function out
[mmh] / man / mhpgp.man1
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH MHPGP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
5 .SH NAME
6 mhpgp \- verify and decrypt a message with gnupg
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B mhpgp
11 .RB [ \-write ]
12 .RB [ \-Version ]
13 .RB [ \-help ]
14 .RI [ +folder ]
15 .RI [ msg ]
16 .ad
17 .SH DESCRIPTION
18 .B mhpgp
19 is a script to simplify verifying and decrypting PGP messages,
20 using gnupg.
21 .PP
22 .B mhpgp
23 can handle signatures and encryption in MIME and plain (non-MIME) format.
24 Signed messages are verified.
25 Encrypted messages are displayed with
26 .B show
27 in decrypted form, the signature is verified as well.
28 .PP
29 With the
30 .B \-write
31 switch, the decrypted message is stored into the current folder.
32 .PP
33 If no
34 .I msg
35 is given, the current message is used.
36 .PP
37 Trailing blanks are stripped from the lines before signature verification,
38 because non are expected to be present as RFC 3156 requests:
39 .PP
40 .RS 5
41 [...] implementations MUST make sure that no trailing
42 whitespace is present after the MIME encoding has been applied.
43 .RE
44 .PP
45 If there is trailing whitespace, it was likely added mistakenly
46 during mail transfer.
47
48 .SH FILES
49 None
50
51 .SH "PROFILE COMPONENTS"
52 None
53
54 .SH "SEE ALSO"
55 mhsign(1), gpg(1)
56
57 .SH DEFAULTS
58 .nf
59 .RB ` +folder "' defaults to the current folder"
60 .RB ` msg "' defaults to the current message"
61 .fi
62
63 .SH CONTEXT
64 None
65
66 .SH BUGS
67 The order of the command line arguments is relevant: The options
68 must come first, the message specification last.