Added an improved user interface for sending messages with attachments.

[mmh] / man / send.man

diff --git a/man/send.man b/man/send.man
index 5a2f897..85b3164 100644 (file)
--- a/man/send.man
+++ b/man/send.man
@@ -40,6 +40,8 @@ send \- send a message
 \&...] 
 .RB [ \-version ]
 .RB [ \-help ]
 \&...] 
 .RB [ \-version ]
 .RB [ \-help ]

+.RB [ \-attach
+.IR header-field-name ]

 .ad
 .SH DESCRIPTION
 .B Send
 .ad
 .SH DESCRIPTION
 .B Send

@@ -63,6 +65,41 @@ profile component.  Most of the features attributed to
 .B send
 are actually performed by
 .BR post .
 .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.
+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.
+.PP
+For file names with dot suffixes, the context is scanned for a
+.I mhshow-suffix-
+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.

 .PP
 If
 .B \-push
 .PP
 If
 .B \-push