Removed -format and -filter from send(1); they were just passed to (s)post(8).
[mmh] / man / send.man1
index c5bec46..bb81ddb 100644 (file)
@@ -10,35 +10,19 @@ send \- send a message
 .B send
 .RB [ \-alias
 .IR aliasfile ]
-.RB [ \-filter
-.IR filterfile ]
-.RB [ \-nofilter ]
-.RB [ \-format " | " \-noformat ]
 .RB [ \-forward " | " \-noforward ]
-.RB [ \-mime " | " \-nomime ]
-.RB [ \-msgid " | " \-nomsgid ]
 .RB [ \-push " | " \-nopush ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-watch " | " \-nowatch ]
-.RB [ \-server
-.IR servername ]
-.RB [ \-port
-.IR port-name/number ]
-.RB [ \-width
-.IR columns ]
 .RB [ msg
 \&...]
 .RB [ \-version ]
 .RB [ \-help ]
-.RB [ \-attach
-.IR header-field-name ]
-.RB [ \-attachformat
-.IR 0 " | " 1 " | " 2 ]
 .ad
 .SH DESCRIPTION
 .B Send
 will cause each of the specified messages to be delivered
-to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq,
+to each of the destinations in the \*(lqTo:\*(rq, \*(lqCc:\*(rq,
 \*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message.  If
 .B send
 is re\-distributing a message, as invoked from
@@ -57,24 +41,18 @@ profile component.  Most of the features attributed to
 .B send
 are actually performed by
 .BR post .
-
 .PP
-If a
-.I header-field-name
-is supplied using the
-.B -attach
-option, the draft is scanned for a header whose field name matches the
-supplied
-.IR header-field-name .
-The draft is converted to a MIME message if one or more matches are found.
+The draft is scanned for attachment header fields.
+Their name defaults to ``Attach'', but may be changed by the value of the
+.I Attachment-Header
+profile entry.
+If such header fields are found, or the body contains non-ASCII characters,
+the message is converted to a MIME message.
 This conversion occurs before all other processing.
 .PP
-The first part of the MIME message is the draft body if that body contains
-any non-blank characters.
-The body of each header field whose name matches the
-.I header-field-name
-is interpreted as a file name, and each file named is included as a separate
-part in the MIME message.
+The first part of the MIME message is the draft body if the body is non-empty.
+The body of each attachment header field is interpreted as a file name,
+and each file named is included as a separate part in the MIME message.
 .PP
 For file names with dot suffixes, the context is scanned for a
 .I mhshow-suffix-
@@ -82,54 +60,15 @@ entry for that suffix.
 The content-type for the part is taken from that context entry if a match is
 found.
 If no match is found or the file does not have a dot suffix, the content-type
-is text/plain if the file contains only ASCII characters or application/octet-stream
-if it contains characters outside of the ASCII range.
-.PP
-Each part contains a name attribute that is the last component of the path name.
-A
-.I x-unix-mode
-attribute containing the file mode accompanies each part.
-Finally, a description attribute is generated by running the
-.I file
-command on the file.
+is text/plain if the file contains only ASCII characters or
+application/octet-stream otherwise.
 .PP
-The
-.B -attachformat
-option specifies the MIME header field formats:  a value of
-.B 0,
-the default,
-includes the
-.I x-unix-mode
-attribute as noted above.  A value of
-.B 1
-suppresses both that and the \*(lqContent-Description\*(rq header, and
-adds a \*(lqContent-Disposition\*(rq header.  A value of
-.B 2
-adds the file
-.I modification-date
-parameter to the \*(lqContent-Disposition\*(rq header.  You can
-specify one value in your profile, and override it for individual
-messages at the
-.I whatnow
-prompt.
-.PP
-Here are example message part headers, for an attachment, for each of the
-.B -attachformat
-values:
+The last component of the path name is taken as the name of the MIME parts.
+A message part header for an attachment might be:
 .PP
 .nf
--attachformat 0:
-Content-Type: text/plain; name="VERSION"; x-unix-mode="0644";
-       charset="us-ascii"
-Content-Description: ASCII text
-
--attachformat 1:
 Content-Type: text/plain; name="VERSION"; charset="us-ascii"
 Content-Disposition: attachment; filename="VERSION"
-
--attachformat 2:
-Content-Type: text/plain; name="VERSION"; charset="us-ascii"
-Content-Disposition: attachment; filename="VERSION"; modification-date="Mon, 19 Dec 2005 22:39:51 -0600"
 .fi
 .PP
 If
@@ -208,20 +147,6 @@ it takes extra effort in most mailers to reply to the included
 message, and so would usually only be done deliberately, rather
 than by accident.
 .PP
-If
-.B \-filter
-.I filterfile
-is specified, then this copy is filtered
-(re\-formatted) by
-.B mhl
-prior to being sent to the blind recipients.
-Alternately, if you specify the
-.B -mime
-switch, then
-.B send
-will
-use the MIME rules for encapsulation.
-.PP
 Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq,
 and \*(lqDate:\ now\*(rq will be appended to the headers in the message.
 If the environment variable
@@ -232,10 +157,6 @@ line of the message.  If this environment variable is not set, then
 .B send
 will consult the profile entry \*(lqSignature\*(rq for
 this information.
-If
-.B \-msgid
-is specified, then a \*(lqMessage\-ID:\*(rq field will also
-be added to the message.
 .PP
 If
 .B send
@@ -247,40 +168,12 @@ If the message already contains a \*(lqFrom:\*(rq field, then a
 \*(lqSender: user@local\*(rq field will be added as well.  (An already
 existing \*(lqSender:\*(rq field is an error!)
 .PP
-By using the
-.B \-format
-switch, each of the entries in the \*(lqTo:\*(rq
-and \*(lqcc:\*(rq fields will be replaced with \*(lqstandard\*(rq
-format entries.  This standard format is designed to be usable by all
-of the message handlers on the various systems around the Internet.
-If
-.B \-noformat
-is given, then headers are output exactly as they appear
-in the message draft.
-.PP
 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
 to the specified folder for the sender in the format in which it will
 appear to any non\-Bcc receivers of the message.  That is, it will have
 the appended fields and field reformatting.  The \*(lqFcc:\*(rq fields
 will be removed from all outgoing copies of the message.
 .PP
-By using the
-.B \-width
-.I columns
-switch, the user can direct
-.B send
-as to how long it should make header lines containing addresses.
-.PP
-If nmh is using the SMTP MTA, the
-.B \-server
-and the
-.B \-port
-switches can be used to override the default mail server (defined by the
-.RI servers
-entry in
-.I %etcdir%/mts.conf
-).
-.PP
 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 additional alias files given by the
 .B \-alias
@@ -310,6 +203,7 @@ for more information.
 ^Draft\-Folder:~^To set the default draft\-folder
 ^Aliasfile:~^For a default alias file
 ^Signature:~^To determine the user's mail signature
+^Attachment\-Header:~^To set the name of the attachment header field
 ^mailproc:~^Program to post failure notices
 ^postproc:~^Program to post the message
 .fi
@@ -320,16 +214,10 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 .SH DEFAULTS
 .nf
 .RB ` msg "' defaults to the current message in the draft folder"
-.RB ` \-nofilter '
-.RB ` \-format '
 .RB ` \-forward '
-.RB ` \-nomime '
-.RB ` \-nomsgid '
 .RB ` \-nopush '
 .RB ` \-noverbose '
 .RB ` \-nowatch '
-.RB ` "\-width\ 72" '
-.RB ` "\-attachformat\ 0" '
 .fi
 
 .SH CONTEXT