X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/ebd71fa45bb0538e65e3106de57a04ae6c70abae..b6fff86c5a551eb0723ff48ca56c653b74dbedf1:/man/mhfixmsg.man?ds=inline diff --git a/man/mhfixmsg.man b/man/mhfixmsg.man index bb80a28f..fcc6dca7 100644 --- a/man/mhfixmsg.man +++ b/man/mhfixmsg.man @@ -1,4 +1,4 @@ -.TH MHFIXMSG %manext1% "March 18, 2013" "%nmhversion%" +.TH MHFIXMSG %manext1% "May 4, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -17,6 +17,7 @@ mhfixmsg \- rewrite MIME messages with various transformations .I codeset .RB "| " \-notextcodeset ] .RB [ \-reformat " | " \-noreformat ] +.RB [ \-replacetextplain " | " \-noreplacetextplain ] .RB [ \-fixboundary " | " \-nofixboundary ] .RB [ \-fixcte " | " \-nofixcte ] .RB [ \-file @@ -36,7 +37,7 @@ rewrites MIME messages, applying specific transformations such as 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 @@ -52,8 +53,19 @@ The .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 text parts encoded in ASCII, +ISO-8859-x, UTF-8, or Windows-12xx. .PP The .B \-textcodeset @@ -83,6 +95,16 @@ inserts that text/plain part at the beginning of the containing multipart/alternative part, if present. If not, it creates a multipart/alternative part. .PP +The +.B \-replacetextplain +switch broadens the applicability of +.B \-reformat +by always replacing a corresponding text/plain part, if one exists. +If +.B \-verbose +if enabled, the replacement will be shown as two steps: a removal of +the text/plain part followed by the usual insertion of a new part. +.PP .B \-reformat requires a profile entry for each text part subtype to be reformatted. The mhfixmsg-format-text/subtype profile entries are based on external @@ -249,6 +271,15 @@ STORE = %libdir%/rcvstore .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 @@ -281,6 +312,7 @@ STORE = %libdir%/rcvstore .RB ` "\-decodetext 8bit"' .RB ` \-notextcodeset ' .RB ` \-reformat ' +.RB ` \-noreplacetextplain ' .RB ` \-fixboundary ' .RB ` \-fixcte ' .RB ` \-noverbose '