X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhbuild.man1;h=2c4bcce896193318ed6d0b83f2b94af97f649f02;hp=babc1b2c166a13ee1e2257f75e0988c9fef30913;hb=8d8f1c3abc586c005c904e52c4adbfe694d2201c;hpb=31dc797eb5178970d68962ca8939da3fd9a8efda diff --git a/man/mhbuild.man1 b/man/mhbuild.man1 index babc1b2..2c4bcce 100644 --- a/man/mhbuild.man1 +++ b/man/mhbuild.man1 @@ -10,7 +10,6 @@ mhbuild \- translate MIME composition draft .B mhbuild .I file .RB [ \-list " | " \-nolist ] -.RB [ \-realsize " | " \-norealsize ] .RB [ \-headers " | " \-noheaders ] .RB [ \-ebcdicsafe " | " \-noebcdicsafe ] .RB [ \-rfc934mode " | " \-norfc934mode ] @@ -64,13 +63,11 @@ to list the table of contents associated with the MIME message that is created. The .B \-headers switch indicates -that a one-line banner should be displayed above the listing. The -.B \-realsize -switch tells -.B mhbuild -to evaluate the \*(lqnative\*(rq -(decoded) format of each content prior to listing. This provides an -accurate count at the expense of a small delay. If the +that a one-line banner should be displayed above the listing. +The size of the \*(lqnative\*(rq +(decoded) format of each content is evaluated. This provides an +accurate count at the expense of a small delay. +If the .B \-verbose switch is present, then the listing will show any \*(lqextra\*(rq information @@ -114,9 +111,8 @@ than one line, e.g., .fi .RE .PP -There are four kinds of directives: +There are three kinds of directives: \*(lqtype\*(rq, -\*(lqexternal-type\*(rq, \*(lqmessage\*(rq (#forw), and \*(lqbegin\*(rq (#begin). .PP @@ -197,55 +193,7 @@ contents should probably be put in the file specified by the environment variable, instead of directly in your user profile. .PP -.B "(2) The \*(lqexternal-type\*(rq directives -are used to provide a MIME -reference to a content, rather than enclosing the contents itself -(for instance, by specifying an ftp site). Hence, instead of -providing a filename as with the type directives, external-parameters -are supplied. These look like regular parameters, so they must be -separated accordingly. For example, -.PP -.RS 5 -.nf -#@application/octet-stream; \\ - type=tar; \\ - conversions=compress \\ - [this is the nmh distribution] \\ - {application; filename="nmh.tar.gz"} \\ - name="nmh.tar.gz"; \\ - directory="/pub/nmh"; \\ - site="ftp.math.gatech.edu"; \\ - access-type=anon-ftp; \\ - mode="image" -.fi -.RE -.PP -You must give a description string to separate the content parameters -from the external-parameters (although this string may be empty). -This description string is specified by enclosing it within -\*(lq[]\*(rq. A disposition string, to appear in a -\*(lqContent-Disposition\*(rq header, may appear in the optional -\*(lq{}\*(rq. -.PP -These parameters are of the form: -.PP -.RS 5 -.nf -.ta \w'access-type= 'u -access-type= usually \fIanon-ftp\fR or \fImail-server\fR -name= filename -permission= read-only or read-write -site= hostname -directory= directoryname (optional) -mode= usually \fIascii\fR or \fIimage\fR (optional) -size= number of octets -server= mailbox -subject= subject to send -body= command to send for retrieval -.fi -.RE -.PP -.B "(3) The \*(lqmessage\*(rq directive (#forw) +.B "(2) The \*(lqmessage\*(rq directive (#forw) is used to specify a message or group of messages to include. You may optionally specify the name of the folder and which messages are to be forwarded. If a folder is not @@ -284,7 +232,7 @@ do not contain encapsulated messages themselves. The drawback of this approach is that the encapsulations are generated by placing an extra newline at the end of the body of each message. .PP -.B "(4) The \*(lqbegin\*(rq directive +.B "(3) The \*(lqbegin\*(rq directive is used to create a multipart content. When using the \*(lqbegin\*(rq directive, you must specify at least one content between the begin and end pairs. @@ -522,15 +470,6 @@ directive ::= "#" type "/" subtype [ filename ] EOL - | "#@" type "/" subtype - 0*(";" attribute "=" value) - [ "(" comment ")" ] - [ "<" id ">" ] - [ "[" description "]" ] - [ "{" disposition "}" ] - external-parameters - EOL - | "#forw" [ "<" id ">" ] [ "[" description "]" ] @@ -590,7 +529,7 @@ line ::= "##" text EOL .fi .SH "SEE ALSO" -mhlist(1), mhshow(1), mhstore(1), +mhlist(1), show(1), mhstore(1), .br .I "Proposed Standard for Message Encapsulation" (RFC\-934), @@ -613,7 +552,6 @@ mhlist(1), mhshow(1), mhstore(1), .SH DEFAULTS .nf .RB ` \-headers ' -.RB ` \-realsize ' .RB ` \-norfc934mode ' .RB ` \-contentid ' .RB ` \-noebcdicsafe '