[ruby.posix.mq] [PATCH] change mailing list to

[Eric Wong <normalperson@yhbt.net>]

The public-inbox + mlmmj setup on bogomips.org allows posting
without subscription and offers downloadable archives via git.
The lack of rsyncable archives on librelist nowadays and
subscription-required nature of librelist are points against it.

Repliers are now encouraged to Cc: all recipients (using the
reply-all function of their mail client) since many readers are
not subscribed.

This project has never accepted or encouraged HTML email, but
librelist accepted it.  The bogomips.org mail server is
configured to treat HTML mail as spam, so do not send HTML mail
if you expect a response.

Users who wish to subscribe may send a message to:

	ruby-posix-mq+subscribe@bogomips.org

Similarly, they may unsubscribe via:

	ruby-posix-mq+unsubscribe@bogomips.org

HTTP archives are available via:

	http://bogomips.org/ruby-posix-mq/

ssoma users may also use: git://bogomips.org/ruby-posix-mq
(see README change)

Old messages to the librelist addresses will continue to
get routed to the new mailing list.

ref: http://public-inbox.org/
---
 Documentation/posix-mq-rb.1.txt |  2 +-
 README                          | 42 ++++++++++++++++++++++++++++++++++-------
 archive/.gitignore              |  3 +++
 archive/slrnpull.conf           |  4 ++++
 lib/posix_mq.rb                 |  2 +-
 posix_mq.gemspec                |  2 +-
 6 files changed, 45 insertions(+), 10 deletions(-)
 create mode 100644 archive/.gitignore
 create mode 100644 archive/slrnpull.conf

diff --git a/Documentation/posix-mq-rb.1.txt b/Documentation/posix-mq-rb.1.txt
index 2972a96..cb56d67 100644
--- a/Documentation/posix-mq-rb.1.txt
+++ b/Documentation/posix-mq-rb.1.txt
@@ -1,5 +1,5 @@
 % posix-mq-rb(1) posix-mq-rb User Manual
-% Ruby POSIX MQ hackers <ruby.posix.mq@librelist.com>
+% Ruby POSIX MQ hackers <ruby-posix-mq@bogomips.org>
 % Jan 1, 2010
 
 # NAME
diff --git a/README b/README
index 9d83f1d..8e41624 100644
--- a/README
+++ b/README
@@ -113,7 +113,7 @@ don't email the git mailing list or maintainer with Ruby posix_mq patches.
 == Contact
 
 All feedback (bug reports, user/development discussion, patches, pull
-requests) go to the mailing list: mailto:ruby.posix.mq@librelist.com
+requests) go to the mailing list: mailto:ruby-posix-mq@bogomips.org
 
 Send patches (from "git format-patch") with "git send-email" and do not
 send HTML email or attachments.  We are very responsive to email and you
@@ -121,10 +121,38 @@ will usually get a response within 24-72 hours.
 
 == Mailing List Archives
 
-In addition to the rsync-able archives provided by http://librelist.com/, we
-are also mirrored to
-{Gmane}[http://gmane.org/info.php?group=gmane.comp.lang.ruby.posix-mq.general]
-and maintain our own mbox mirrors downloadable via HTTP.
+We operate a {public-inbox}[http://public-inbox.org/] which
+feeds the mailing list.  You may subscribe either using
+{ssoma}[http://ssoma.public-inbox.org/] or by sending a mail
+to mailto:ruby-posix-mq+subscribe@bogomips.org
 
-* nntp://news.gmane.org/gmane.comp.lang.ruby.posix-mq.general
-* http://bogomips.org/ruby_posix_mq/archives/
+ssoma is a mail archiver/fetcher using git.  It operates in a similar
+fashion to tools such as slrnpull, fetchmail, or getmail.  ssoma
+subscription instructions:
+
+    URL=git://bogomips.org/ruby-posix-mq
+    LISTNAME=ruby-posix-mq
+
+    # to initialize a maildir (this may be a new or existing maildir,
+    # ssoma will not touch existing messages)
+    # If you prefer mbox, use mbox:/path/to/mbox as the last argument
+    # You may also use imap://$MAILSERVER/INBOX for an IMAP account
+    # or imaps:// for an IMAPS account, as well.
+    ssoma add $LISTNAME $URL maildir:/path/to/maildir
+
+    # read with your favorite MUA (only using mutt as an example)
+    mutt -f /path/to/maildir # (or /path/to/mbox)
+
+    # to keep your mbox or maildir up-to-date, periodically run:
+    ssoma sync $LISTNAME
+
+    # your MUA may modify and delete messages from the maildir or mbox,
+    # this does not affect ssoma functionality at all
+
+    # to sync all your ssoma subscriptions
+    ssoma sync
+
+    # You may wish to sync in your cronjob
+    ssoma sync --cron
+
+* http://bogomips.org/ruby-posix-mq/
diff --git a/archive/.gitignore b/archive/.gitignore
new file mode 100644
index 0000000..bd7ad57
--- /dev/null
+++ b/archive/.gitignore
@@ -0,0 +1,3 @@
+/data
+/news
+/requests
diff --git a/archive/slrnpull.conf b/archive/slrnpull.conf
new file mode 100644
index 0000000..dc038e2
--- /dev/null
+++ b/archive/slrnpull.conf
@@ -0,0 +1,4 @@
+# group_name                         max        expire     headers_only
+gmane.comp.lang.ruby.posix-mq.general 1000000000 1000000000 0
+
+# usage: slrnpull -d $PWD -h news.gmane.org --no-post
diff --git a/lib/posix_mq.rb b/lib/posix_mq.rb
index 60c63b6..5424667 100644
--- a/lib/posix_mq.rb
+++ b/lib/posix_mq.rb
@@ -41,7 +41,7 @@ class POSIX_MQ
   # SIGEV_THREAD functionality in mq_notify(3).  So far we only
   # know of glibc + Linux supporting this.  Please let us
   # know if your platform can support this functionality and
-  # are willing to test for us <ruby.posix.mq@librelist.com>
+  # are willing to test for us <ruby-posix-mq@bogomips.org>
   #
   # As far as we can tell, this method is not very useful
   # nor efficient.  You would be better served using signals or
diff --git a/posix_mq.gemspec b/posix_mq.gemspec
index 2523328..ee236f3 100644
--- a/posix_mq.gemspec
+++ b/posix_mq.gemspec
@@ -11,7 +11,7 @@ Gem::Specification.new do |s|
   s.authors = ["Ruby POSIX MQ hackers"]
   s.date = Time.now.utc.strftime('%Y-%m-%d')
   s.description = readme_description
-  s.email = %q{ruby.posix.mq@librelist.com}
+  s.email = %q{ruby-posix-mq@bogomips.org}
   s.executables = %w(posix-mq-rb)
   s.extensions = %w(ext/posix_mq/extconf.rb)
   s.extra_rdoc_files = extra_rdoc_files(manifest)
-- 
EW