X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fsendfiles.man1;h=434be09149e3c474e755464ec59b69d1050576bc;hp=a2bf7beb633badbb2e4132462ec7518c8d0536a9;hb=31750e8a12eafcd1b8fa81cb12b988e680254f24;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9

diff --git a/man/sendfiles.man1 b/man/sendfiles.man1
index a2bf7be..434be09 100644
--- a/man/sendfiles.man1
+++ b/man/sendfiles.man1
@@ -3,155 +3,55 @@
 .\"
 .TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-sendfiles \- send multiple files via a MIME message
+sendfiles \- send multiple files in a MIME message
 .SH SYNOPSIS
-.HP
+.HP 5
 .na
 .B sendfiles
-.I mailpath
+.I recipient
 .I subject
-.I file1
-.RI [ file2
-\&...]
+.IR file ...
 .ad
 .SH DESCRIPTION
-The shell script
+The program
 .BR sendfiles ,
 is used to send a collection
-of files and directories via electronic mail.
-.PP
-.RS 5
-sendfiles mailpath \*(lqsubject\*(rq files\0...
-.RE
-.PP
-.B sendfiles
-will archive the files and directories you name
-with the
-.B tar
-command, and then mail the compressed
-archive to the \*(lqmailpath\*(rq with the given \*(lqsubject\*(rq.
-.PP
-Sometimes you want
-.B sendfiles
-to pause after posting a partial
-message.  This is usually the case when you are running
-.B sendmail
-and expect to generate a lot of partial messages.  If the first
-argument given to
+of files via electronic mail.
 .B sendfiles
-starts with a dash, then it is
-interpreted as the number of seconds to pause in between postings,
-e.g.,
-.PP
-.RS 5
-sendfiles -30 mailpath \*(lqsubject\*(rq files\0...
-.RE
-.PP
-will pause 30 seconds in between each posting.
-.PP
-.SS "Extracting the Received Files"
-When these messages are received, invoke
-.B mhstore
-once for
-the list of messages.  The default is for
-.B mhstore
-to store
-the combined parts as a new message in the current folder, although
-this can be changed using storage formatting strings.  You can then
-use
-.B mhlist
-to find out what's inside; possibly followed by
-.B mhstore
-again to write the archive to a file where you can
-subsequently uncompress and untar it.  For instance:
-.PP
-.RS 5
-.nf
-% mhlist 5-8
- msg part  type/subtype             size description
-   5       message/partial           47K part 1 of 4
-   6       message/partial           47K part 2 of 4
-   7       message/partial           47K part 3 of 4
-   8       message/partial           18K part 4 of 4
-% mhstore 5-8
-reassembling partials 5,6,7,8 to folder inbox as message 9
-% mhlist -verbose 9
- msg part  type/subtype             size description
-   9       application/octet-stream 118K
-             (extract with uncompress | tar xvpf -)
-             type=tar
-             conversions=compress
-% mhstore 9
-% uncompress < 9.tar.Z | tar xvpf -
-.fi
-.RE
-.PP
-Alternately, by using the
-.B \-auto
-switch,
-.B mhstore
-will automatically do the extraction for you:
+will mail the files in one message with the given `subject'
+to the `recipient'.
+Take care not to generate too large messages, as there usually are
+size limits enforced by the MTAs.
 .PP
-.RS 5
-.nf
-% mhlist 5-8
- msg part  type/subtype             size description
-   5       message/partial           47K part 1 of 4
-   6       message/partial           47K part 2 of 4
-   7       message/partial           47K part 3 of 4
-   8       message/partial           18K part 4 of 4
-% mhstore 5-8
-reassembling partials 5,6,7,8 to folder inbox as message 9
-% mhlist -verbose 9
- msg part  type/subtype             size description
-   9       application/octet-stream 118K
-             (extract with uncompress | tar xvpf -)
-             type=tar
-             conversions=compress
-% mhstore -auto 9
--- tar listing appears here as files are extracted
-.fi
-.RE
-.PP
-As the second
-.B tar
-listing is generated, the files are extracted.
-A prudent user will never put
-.B \-auto
-in the profile.
-The correct procedure is to first use
-.B mhlist
-to find out what will be extracted.  Then
-.B mhstore
-can be invoked with
-.B \-auto
-to perform the extraction.
+To extract received files, use
+.B mhstore .
 
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%etcdir%/FileName  'u
 ^$HOME/.mmh/profile~^The user profile
 .fi
 
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's mail storage
-^Current\-Folder:~^To find the default current folder
-.fi
+None
 
 .SH "SEE ALSO"
-mhbuild(1), mhlist(1), mhshow(1), mhstore(1).
-.I "Proposed Standard for Message Encapsulation"
-(RFC\-934)
-
-.SH DEFAULTS
-.nf
-.RB ` \-noverbose '
-.fi
+send(1), mhlist(1), mhstore(1).
 
 .SH CONTEXT
 None
+
+.SH HISTORY
+.PP
+This is a new and simpler version of
+.B sendfiles ,
+which directly invokes
+.B send .
+The old one had invoked
+.B viamail .
+The old version had been able to send whole directories, by automatically
+tarballing them. This new version is not able to do so.
+The old man page had described some kind of automatical splitting of
+large content into `message/partial' parts. However, it appears as if this
+had been removed earlier, only its documentation remained.