X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhstore.man1;h=395b76a0c1d1831acf3a6de35af2573b4cef095e;hp=acf36947a27471aa1db821b9f25f6fae4a3fc6de;hb=0073224c28bf81dad1812d406bb9915b24b23eb6;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9

diff --git a/man/mhstore.man1 b/man/mhstore.man1
index acf3694..395b76a 100644
--- a/man/mhstore.man1
+++ b/man/mhstore.man1
@@ -312,6 +312,48 @@ are combined in the correct order.  But if
 can not
 locate every partial necessary to reassemble the message, it will
 not store anything.
+RE
+.PP
+By using the
+.B \-auto
+switch,
+.B mhstore
+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
+ 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.
 .SS "External Access"
 For contents of type message/external-body,
 \fImhstore\fR supports these access-types:
@@ -353,11 +395,6 @@ local filename
 .PP
 The program should terminate with an exit status of zero if the
 retrieval is successful, and a non-zero exit status otherwise.
-.PP
-If this entry is not provided, then
-.B mhstore
-will use a simple
-built-in FTP client to perform the retrieval.
 .SS "The Content Cache"
 When
 .B mhstore