From: Eric Wong <e@80x24.org>
Date: Mon, 21 Apr 2014 08:56:22 +0000 (+0000)
Subject: doc: various fixes and URL changes
X-Git-Tag: v0.0.0~2
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=756f9177d27b2f836963e1faafcdd09194bf2762;p=ssoma-mda.git

doc: various fixes and URL changes

We don't need a specific list for ssoma, yet, just use the
meta@public-inbox.org list to avoid fragmentation.
---

diff --git a/Documentation/ssoma-mda.txt b/Documentation/ssoma-mda.txt
index f084eca..3b6757b 100644
--- a/Documentation/ssoma-mda.txt
+++ b/Documentation/ssoma-mda.txt
@@ -37,7 +37,7 @@ ssoma-mda depends on no environment variables
 # CONTACT
 
 All feedback welcome via plain-text mail to <meta@public-inbox.org>\
-The mail archives are hosted at git://public-inbox.org/ssoma
+The mail archives are hosted at git://public-inbox.org/meta
 See ssoma(1) for instructions on how to subscribe.
 
 # COPYRIGHT
diff --git a/Documentation/ssoma-rm.txt b/Documentation/ssoma-rm.txt
index 89255fc..0e3aa2b 100644
--- a/Documentation/ssoma-rm.txt
+++ b/Documentation/ssoma-rm.txt
@@ -19,8 +19,8 @@ of "ssoma sync" from seeing the message in their mailbox.
 
 # CONTACT
 
-All feedback welcome via plain-text mail to <ssoma@public-inbox.org>\
-The mail archives are hosted at git://public-inbox.org/ssoma
+All feedback welcome via plain-text mail to <meta@public-inbox.org>\
+The mail archives are hosted at git://public-inbox.org/meta
 See ssoma(1) for instructions on how to subscribe.
 
 # COPYRIGHT
diff --git a/Documentation/ssoma.txt b/Documentation/ssoma.txt
index 3fab29b..f05e230 100644
--- a/Documentation/ssoma.txt
+++ b/Documentation/ssoma.txt
@@ -6,18 +6,22 @@ ssoma - mail archive synchronization and extraction client
 
 # SYNOPSIS
 
-ssoma add LISTNAME URL maildir:/path/to/maildir/
+ssoma add LISTNAME URL maildir:/path/to/maildir/ [TARGET]
+
 ssoma add LISTNAME URL mbox:/path/to/mbox
+
 ssoma add LISTNAME URL imap://USER@HOST/INBOX
-ssoma sync [LISTNAME]
+
+ssoma sync [--since=DATE] [LISTNAME]
+
 ssoma cat MESSAGE-ID [LISTNAME|GIT_DIR]
 
 # DESCRIPTION
 
-The client component of ssoma may be used to sync and export mail to Maildir
-or mbox(5) from any published ssoma git repository.
+ssoma may be used to sync and export mail to Maildir, IMAP or mbox(5)
+from any published ssoma git repository.
 
-* add LISTNAME URL DESTINATION
+* add LISTNAME URL DESTINATION [TARGET]
 
 This starts a subscription to a mailing list by configuring a git
 repository.  LISTNAME is a name of your choosing.  It must only consist
@@ -35,14 +39,23 @@ IMAP users may configure the imap.pass and imap.tunnel variables in
 ~/.ssoma/$LISTNAME.git/config in the same way as git-imap-send(1).
 Remember to restrict permissions to ~/.ssoma/$LISTNAME.git/config
 if you are storing a password in it.
+.
+TARGET may optionally be specified if you wish to extract a list
+to multiple destinations (e.g. an mbox for certain tools, but also
+to your IMAP account).  The default TARGET name is "local".
 
-* sync [LISTNAME]
+* sync [--since=DATE] [LISTNAME] [TARGET]
 
 This clones/fetches from the remote git repository into the local
 repository and extracts messages into destinations configured with the
 "add" sub-command.  If LISTNAME is not given, all list subscriptions are
 synchronized.  If LISTNAME is given, only subscriptions for a given LISTNAME
+is synchronized.  If TARGET is also given, the only the specified TARGET
 is synchronized.
+.
+If you are following a list with a long history, you may only want to
+extract recent messages by specifying --since=DATE and passing any DATE
+format understood by git-log(1).
 
 * cat MESSAGE-ID [LISTNAME|GIT_DIR]
 
@@ -64,16 +77,16 @@ This is useful for testing, but not recommended otherwise.
 
 # CONTACT
 
-All feedback welcome via plain-text mail to <ssoma@public-inbox.org>\
-The mail archives are hosted at git://public-inbox.org/ssoma
+All feedback welcome via plain-text mail to <meta@public-inbox.org>\
+The mail archives are hosted at git://public-inbox.org/meta
 You may subscribe using ssoma:
 
-	ssoma add ssoma git://public-inbox.org/ssoma mbox:/path/to/mbox
-	ssoma sync ssoma
+	ssoma add pi git://public-inbox.org/meta mbox:/path/to/mbox
+	ssoma sync pi
 
 # SOURCE CODE
 
-	git clone git://bogomips.org/ssoma
+	git clone git://80x24.org/ssoma
 
 # COPYRIGHT
 
diff --git a/README b/README
index 8b00f60..d10d676 100644
--- a/README
+++ b/README
@@ -26,7 +26,7 @@ Hacking
 -------
 Source code is available via git:
 
-	git clone git://bogomips.org/ssoma
+	git clone git://80x24.org/ssoma
 
 See below for contact info.