X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/c43afcbaf482a3e7227ca839633c0f7488944895..68a2f1066121da202e4a793e4e170271ed530676:/man/mhbuild.man diff --git a/man/mhbuild.man b/man/mhbuild.man index d127de8d..57441dad 100644 --- a/man/mhbuild.man +++ b/man/mhbuild.man @@ -1,7 +1,7 @@ +.TH MHBUILD %manext1% "January 4, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" -.TH MHBUILD %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mhbuild \- translate MIME composition draft .SH SYNOPSIS @@ -13,7 +13,6 @@ mhbuild \- translate MIME composition draft .RB [ \-realsize " | " \-norealsize ] .RB [ \-headers " | " \-noheaders ] .RB [ \-directives " | " \-nodirectives ] -.RB [ \-ebcdicsafe " | " \-noebcdicsafe ] .RB [ \-rfc934mode " | " \-norfc934mode ] .RB [ \-contentid " | " \-nocontentid ] .RB [ \-verbose " | " \-noverbose ] @@ -139,7 +138,6 @@ errors: .nf #off #include - printf("Hello, World!); #pop .fi @@ -468,12 +466,11 @@ If .B mhbuild is given the .B \-check -switch, then it will also associate -an integrity check with each \*(lqleaf\*(rq content. This will add a -Content-MD5 header field to the content, along with the md5 sum of the -unencoded contents. This may be used by the receiver of the message to -verify that the contents of the message were not changed in transport. - +switch, then it will also associate an integrity check with each +\*(lqleaf\*(rq content. This will add a Content-MD5 header field to +the content, along with the md5 sum of the unencoded contents, per RFC +1864. This may be used by the receiver of the message to verify that +the contents of the message were not changed in transport. .SS "Transfer Encodings" After .B mhbuild @@ -492,22 +489,10 @@ will encode each content with a transfer encoding, even it the content contains only 7\-bit data. This is to increase the likelihood that the content is not changed while in transport. -.PP -The switch -.B \-ebcdicsafe -will cause -.B mhbuild -to slightly change -the way in which it performs the \*(lqquoted-printable\*(rq transfer -encoding. Along with encoding 8\-bit characters, it will now also encode -certain common punctuation characters as well. This slightly reduces the -readability of the message, but allows the message to pass more reliably -through mail gateways which involve the EBCDIC character encoding. - .SS "Invoking mhbuild" Typically, .B mhbuild - is invoked by the +is invoked by the .B whatnow program. This command will expect the body of the draft to be formatted as an @@ -563,7 +548,6 @@ What now? list .RE .PP will work as you expect. - .SS "User Environment" Because the environment in which .B mhbuild @@ -588,7 +572,6 @@ user profile, e.g., .RE .PP if it exists. - .SS "Syntax of Composition Files" The following is the formal syntax of a .B mhbuild @@ -655,8 +638,6 @@ line ::= "##" text EOL | text EOL .fi .RE -.PP - .SH FILES .fc ^ ~ .nf @@ -665,7 +646,6 @@ line ::= "##" text EOL ^$MHBUILD~^Additional profile entries ^%etcdir%/mhn.defaults~^System default MIME profile entries .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -675,28 +655,31 @@ line ::= "##" text EOL ^Current\-Folder:~^To find the default current folder ^mhbuild-compose-*~^Template for composing contents .fi - .SH "SEE ALSO" -mhlist(1), mhshow(1), mhstore(1), -.br +.IR mhlist (1), +.IR mhshow (1), +.IR mhstore (1) +.PP .I "Proposed Standard for Message Encapsulation" (RFC\-934), -.br +.PP +.I "The Content-MD5 Header Field" +(RFC\-1864), +.PP .I "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies" (RFC\-2045), -.br +.PP .I "Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types" (RFC\-2046), -.br +.PP .I "Multipurpose Internet Mail Extensions (MIME) Part Three: Message Header Extensions for Non-ASCII Text" (RFC\-2047), -.br +.PP .I "Multipurpose Internet Mail Extensions (MIME) Part Four: Registration Procedures" (RFC\-2048), -.br +.PP .I "Multipurpose Internet Mail Extensions (MIME) Part Five: Conformance Criteria and Examples" (RFC\-2049) - .SH DEFAULTS .nf .RB ` \-headers ' @@ -704,6 +687,5 @@ mhlist(1), mhshow(1), mhstore(1), .RB ` \-norfc934mode ' .RB ` \-contentid ' .RB ` \-nocheck ' -.RB ` \-noebcdicsafe ' .RB ` \-noverbose ' .fi