Merge branch 'master' of git.sv.nongnu.org:/srv/git/nmh

[nmh] / man / mhfixmsg.man

diff --git a/man/mhfixmsg.man b/man/mhfixmsg.man
index 1d1d67850fdef1d2c9d01b88a466bd5c806bf08e..629014d6c68470a6c5de46e0e0689e9766a45bf4 100644 (file)
--- a/man/mhfixmsg.man
+++ b/man/mhfixmsg.man
@@ -1,4 +1,4 @@
-.TH MHFIXMSG %manext1% "March 17, 2013" "%nmhversion%"
+.TH MHFIXMSG %manext1% "May 4, 2013" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"


@@ -23,6 +23,9 @@ mhfixmsg \- rewrite MIME messages with various transformations
 .IR file ]
 .RB [ \-outfile
 .IR outfile ]
 .IR file ]
 .RB [ \-outfile
 .IR outfile ]

+.RB [ \-rmmproc
+.IR program ]
+.RB [ \-normmproc ]

 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]


@@ -33,7 +36,7 @@ rewrites MIME messages, applying specific transformations such as
 decoding of MIME-encoded message parts and repairing invalid MIME
 headers.
 .PP
 decoding of MIME-encoded message parts and repairing invalid MIME
 headers.
 .PP

-MIME messages are specified in RFC\-2045 to RFC\-2049
+MIME messages are specified in RFC 2045 to RFC 2049

 (see
 .IR mhbuild (1)).
 The
 (see
 .IR mhbuild (1)).
 The


@@ -49,8 +52,18 @@ The
 .B \-decodetext
 switch enables a transformation to decode each base64 and
 quoted-printable text message part to the selected 8bit or 7bit
 .B \-decodetext
 switch enables a transformation to decode each base64 and
 quoted-printable text message part to the selected 8bit or 7bit

-encoding.  If the decoded text would not fit the selected encoding as
-defined by RFC-2045, the part is not decoded.
+encoding.  If 7bit is selected for a base64 part but it will only fit
+8bit, as defined by RFC 2045, then it will be decoded to 8bit
+quoted-printable.  Otherwise, if the decoded text would not fit the
+selected encoding, the part is not decoded (and a message will be
+displayed if
+.B \-verbose
+is enabled).
+.PP
+When the
+.B \-decodetext
+switch is enabled, each carriage return character that precedes a
+linefeed character is removed from ASCII-encoded text parts.

 .PP
 The
 .B \-textcodeset
 .PP
 The
 .B \-textcodeset


@@ -203,6 +216,15 @@ That is, it uses the
 profile component, if present.  If not present,
 .B mhfixmsg
 moves the original message to a backup file.
 profile component, if present.  If not present,
 .B mhfixmsg
 moves the original message to a backup file.

+The
+.B \-rmmproc
+switch may be used to override this profile component.  The
+.B \-normmproc
+switch disables the use of any
+.I rmmproc
+profile component and negates all prior
+.B \-rmmproc
+switches.

 .PP
 .SS "Integration with procmail"
 By way of example, here is an excerpt from a procmailrc file
 .PP
 .SS "Integration with procmail"
 By way of example, here is an excerpt from a procmailrc file


@@ -230,13 +252,22 @@ MKTEMP = 'mktemp Backups/mhfixmsg.XXXXXXXX'
 MHFIXMSG = 'mhfixmsg -noverbose -file - -outfile -'
 STORE = %libdir%/rcvstore
 
 MHFIXMSG = 'mhfixmsg -noverbose -file - -outfile -'
 STORE = %libdir%/rcvstore
 

-:0 w: nmh/procmail.$LOCKEXT
+:0 w: nmh-worker/procmail.$LOCKEXT

 * ^TOnmh-workers@nongnu.org
 | tee `$MKTEMP` | $MHFIXMSG | $STORE +nmh-workers
 .fi
 .RE
 .PP
 .SH FILES
 * ^TOnmh-workers@nongnu.org
 | tee `$MKTEMP` | $MHFIXMSG | $STORE +nmh-workers
 .fi
 .RE
 .PP
 .SH FILES

+.B mhfixmsg
+looks for mhn.defaults in multiple locations: absolute pathnames are
+accessed directly, tilde expansion is done on usernames, and files are
+searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP

 .fc ^ ~
 .nf
 .ta \w'%etcdir%/mhn.defaults  'u
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/mhn.defaults  'u