X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/a2c417d3e1641ba4ab151b7945b90f55176705b1..c1e7215519ea50d95fc30d0a8064db6633a7d559:/man/mhbuild.man

diff --git a/man/mhbuild.man b/man/mhbuild.man
index c1237a75..48fde881 100644
--- a/man/mhbuild.man
+++ b/man/mhbuild.man
@@ -1,4 +1,4 @@
-.TH MHBUILD %manext1% "September 23, 2016" "%nmhversion%"
+.TH MHBUILD %manext1% "October 15, 2016" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,6 +8,8 @@ mhbuild \- translate MIME composition draft
 .na
 .HP 5
 .B mhbuild
+.RB [ \-help ]
+.RB [ \-version ]
 .I file
 .RB [ \-auto " | " \-noauto ]
 .RB [ \-list " | " \-nolist ]
@@ -25,8 +27,6 @@ mhbuild \- translate MIME composition draft
 .RB [ \-maxunencoded
 .IR line\-length ]
 .RB [ \-dist ]
-.RB [ \-version ]
-.RB [ \-help ]
 .ad
 .SH DESCRIPTION
 The
@@ -104,7 +104,7 @@ An
 message using normal MIME encapsulation rules.
 One filename is allowed
 per \*(lqAttach\*(rq header, but multiple \*(lqAttach\*(rq headers are
-allowed ber composition file.
+allowed per composition file.
 .PP
 These files will be appended after any other MIME content, including any
 content specified by
@@ -194,6 +194,7 @@ entry, e.g.,
 excludes parts of that
 .I TYPE
 from the draft.
+.PP
 The
 .I mhn.defaults
 file
@@ -204,7 +205,9 @@ and
 entries.
 Profile entries can be used to override corresponding
 .I mhn.defaults
-entries, as usual.
+entries, as usual.  Text converters should limit text line lengths
+to a maximum of 78 characters, and must limit them to a maximum of 998
+characters, per RFC 5322 Sec.\& 2.1.1.
 .PP
 For each
 .I TYPE
@@ -214,14 +217,13 @@ part in
 runs
 .I CONVERTER ARGSTRING
 on the content of the part.
-.PP
 Each part in
 .I FILE
 that has no corresponding TYPE entry in the profile or
 .I mhn.defaults
 is
 excluded from the draft; the user can include them using mhbuild
-directives as usual.
+directives.
 .PP
 .B repl
 inserts
@@ -534,7 +536,7 @@ url=	URL of content
 .fi
 .RE
 .PP
-A mimimum \*(lqexternal\-type\*(rq directive for the
+A minimum \*(lqexternal\-type\*(rq directive for the
 .B url
 .I access\-type
 would be as follows:
@@ -765,18 +767,19 @@ switch will indicate which algorithm to use when encoding any message headers
 that contain 8\-bit characters.
 The valid arguments are
 .I base64
-for based\-64 encoding,
+for base\-64 encoding,
 .I quoted
 for quoted\-printable encoding, and
-.I 8bit
-for raw 8-bit encoding, which requires that all header field bodies be
-encoded as UTF-8 (RFC 6530) and that the SMTP server support SMTPUTF8
-(RFC 6531).
+.I utf\-8
+which requires that all 8\-bit header field bodies be encoded as UTF\-8
+(RFC 6530) and that the message be sent to a SMTP server that supports
+SMTPUTF8 (RFC 6531).
 The
 .B \-autoheaderencoding
-switch will instruct
+switch instructs
 .B mhbuild
-to automatically pick the algorithm that results in a shorter encoded string.
+to automatically pick the encoding, either base64 or quoted\-printable,
+that results in a shorter encoded string.
 .PP
 Putting this all together,
 here is an example of a more complicated message draft.
@@ -830,7 +833,7 @@ the
 switch, then
 .B mhbuild
 will encode each content with
-a transfer encoding, even it the content contains only 7\-bit data.
+a transfer encoding, even if the content contains only 7\-bit data.
 This
 is to increase the likelihood that the content is not changed while in
 transport.
@@ -1050,6 +1053,9 @@ Template for composing contents.
 .I "Multipurpose Internet Mail Extensions (MIME) Part Three: Message Header Extensions for Non-ASCII Text"
 (RFC 2047)
 .PP
+.I "Internet Message Format"
+(RFC 5322)
+.PP
 .I "MIME Parameter Value and Encoded Word Extensions: Character Sets, Languages, and Continuations"
 (RFC 2231)
 .PP