]> diplodocus.org Git - nmh/blobdiff - man/sendfiles.man
Handle teen ordinal suffixes correctly.
[nmh] / man / sendfiles.man
index ba1fef0037266d2a2a1423008a92531663c95452..3d2e2724aa0356d507fd7787eaf8683389289832 100644 (file)
@@ -1,21 +1,20 @@
-.TH SENDFILES %manext1% "October 21, 2012" "%nmhversion%"
-.\"
+.TH SENDFILES %manext1% 2012-11-14 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
-sendfiles \- send multiple files via a MIME message
+sendfiles \- send multiple files by MIME message with nmh
 .SH SYNOPSIS
 .HP 5
 .na
 .B sendfiles
+.RB [ \-help ]
+.RB [ \-version ]
 .RB [ -compress
 .IR bzip2 " | " compress " | " gzip " | " lzma " | " none ]
 .br
 .RB [ \-from
 .IR sender ]
-.RI [ "\-delay n" " | " \-n ]
-.RB [ \-version ]
-.RB [ \-help ]
 .br
 .B \-to
 .I recipient
@@ -30,7 +29,7 @@ sendfiles \- send multiple files via a MIME message
 .ad
 .SH DESCRIPTION
 The shell script
-.BR sendfiles
+.B sendfiles
 is used to send a collection
 of files and directories via electronic mail.
 .PP
@@ -40,9 +39,6 @@ with the
 .B tar
 command, and then mail the compressed
 archive to the \*(lqrecipient\*(rq with the given \*(lqsubject\*(rq.
-The archive
-will be automatically split up into as many messages as necessary
-in order to get past most mailers.
 .PP
 The
 .B \-to
@@ -76,59 +72,25 @@ of the compression program by
 .BR \-none )
 disables compression.
 .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.  The
-.B \-delay
-switch specifies the number of seconds to pause in between postings,
-e.g.,
-.PP
-.RS 5
-sendfiles -delay 30 -to recipient -subject \*(lqsubject\*(rq files\0...
-.RE
-.PP
-will pause 30 seconds in between each posting.  An alternate form of
-the switch with just the delay time,
-.BR \-30 ,
-for example, is also supported.
-.PP
 .SS "Extracting the Received Files"
-When these messages are received, invoke
+When the message is received, invoke
 .B mhstore
 once for
-the list of messages.  The default is for
+the received message.  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
+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
+$ 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 -
+$ mhstore 9
+$ uncompress < 9.tar.Z | tar xvpf -
 .fi
 .RE
 .PP
@@ -140,21 +102,13 @@ will automatically do the extraction for you:
 .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
+$ 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
+$ mhstore -auto 9
 -- tar listing appears here as files are extracted
 .fi
 .RE
@@ -165,7 +119,7 @@ listing is generated, the files are extracted.
 A prudent user will never put
 .B \-auto
 in the
-.I \&.mh\(ruprofile
+.I \&.mh_profile
 file.  The correct procedure is to first use
 .B mhlist
 to find out what will be extracted.  Then
@@ -176,8 +130,8 @@ to perform the extraction.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~