You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ponymail.apache.org by se...@apache.org on 2016/11/05 13:43:39 UTC

incubator-ponymail git commit: --attachments qualifier was dropped some while ago

Repository: incubator-ponymail
Updated Branches:
  refs/heads/master 3de20d919 -> 7f158c95e


--attachments qualifier was dropped some while ago

Document single file import

Project: http://git-wip-us.apache.org/repos/asf/incubator-ponymail/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-ponymail/commit/7f158c95
Tree: http://git-wip-us.apache.org/repos/asf/incubator-ponymail/tree/7f158c95
Diff: http://git-wip-us.apache.org/repos/asf/incubator-ponymail/diff/7f158c95

Branch: refs/heads/master
Commit: 7f158c95e177ab39adc472834fb292c5da8b24a0
Parents: 3de20d9
Author: Sebb <se...@apache.org>
Authored: Sat Nov 5 13:43:25 2016 +0000
Committer: Sebb <se...@apache.org>
Committed: Sat Nov 5 13:43:25 2016 +0000

----------------------------------------------------------------------
 docs/IMPORTING.md | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-ponymail/blob/7f158c95/docs/IMPORTING.md
----------------------------------------------------------------------
diff --git a/docs/IMPORTING.md b/docs/IMPORTING.md
index a193fd2..465cd28 100644
--- a/docs/IMPORTING.md
+++ b/docs/IMPORTING.md
@@ -9,9 +9,6 @@ the archive. Both the archiver and the importer use the same digest method, so
 they can overlap. Usually, you'll want to set up the archiver first, and when
 emails start flowing through it, you'll use the importer to import older emails.
 
-## Importing attachments
-If you wish to import attached files, add the `--attachments` flag to your import command, otherwise, attachments will be stripped.
-
 ## Importing from mod_mbox
 
 ### Importing a single domain
@@ -20,7 +17,7 @@ https://your.tld/mod_mbox/$list-yourdomain/, you can import all lists from that
 
 `python3 import-mbox.py --source https://your.tld/mod_mbox/ --mod-mbox --project yourdomain`
 
-For a quick update, which only imports the last 2 months of mail, append then `--quick` flag.
+For a quick update, which only imports the last 2 months of mail, append the `--quick` flag.
 
 You can also import just a single list by specifying that list ID:
 
@@ -53,11 +50,27 @@ While the `project` flag is not needed here, you may wish to specify the list ID
 ## Importing from locally stored mbox files
 To import from one or more local mbox files, specify a filesystem path as the source:
 
-`python3 import-mbox.py --source /tmp/mylists/ --attachments`
+`python3 import-mbox.py --source /tmp/mylists/`
+
+This will recursively import all files with the extension '.mbox'.
+
+You can change the extension as follows:
+
+`python3 import-mbox.py --source /tmp/mylists/ --ext .mbx`
+
+To match all files with any non-empty extension:
+
+`python3 import-mbox.py --source /tmp/mylists/ --ext '.*'`
+
+To match files regardless of extension:
+
+`python3 import-mbox.py --source /tmp/mylists/ --ext ''`
+
+Or you can import a single file:
 
-If you have a mix of mbox and non-mbox files in the specific dir, you may wish to let Pony Mail know which files to scan:
+`python3 import-mbox.py --source 2016-11.mbox`
 
-`python3 import-mbox.py --source /tmp/mylists/ --ext .mbox --attachments`
+(This is supported in versions after 0.9)
 
 ## Test archives
 We have a few test archives for those that wish to test large imports.