New donator - thanks, Michael Roach!
[ikiwiki.git] / docs / user / mailing_list_commands / index.mdwn
index 2b80412..dcb98d1 100644 (file)
@@ -1,8 +1,8 @@
-The DragonFly mailing lists use BestServ to handle mailing list administration
+The DragonFly mailing lists use BestServ to handle mailing list administration.  This document describes how to interact with BestServ to subscribe and unsubscribe to the mailing lists, and other ways to interact with the lists.
 
 ## For the impatient
 
-Mail **listname-request@dragonflybsd.org**, where **listname** is the name of the mailing list you want to subscribe to.  You will get a confirmation email.  Reply to this email after changing "REJECT" to "ACCEPT" in the subject.
+Mail ***listname-request@dragonflybsd.org***, where ***listname*** is the name of the mailing list you want to subscribe to.  You will get a confirmation email.  Reply to this email after changing "REJECT" to "ACCEPT" in the subject.
 
 If you want to test your subscription, use the test@dragonflybsd.org list.
 
@@ -37,13 +37,18 @@ The purpose of authentication is to ensure that a valid return email address exi
 
 ## Subscribing
 
-To subscribe to a list you normally send email to the -request address of the list, as in 'test-request@hostname.domain'. The body of the message should contain the keyword 'subscribe' alone or, if you want to subscribe a third party address, the subscribe keyword may be followed by an email address.
+To subscribe to a list you normally send email to the -request address of the list, as in 'test-request@hostname.domain'. The body of the message should contain the keyword 'subscribe' alone or, if you want to subscribe a third party address, the subscribe keyword may be followed by an email address. Like this:
 
-      subscribe
+    To: test-request@dragonflybsd.org
+    Subject: blah
+
+    subscribe
 
 or
+    To: test-request@dragonflybsd.org
+    Subject: blah
 
-      subscribe email-address
+    subscribe email-address
 
 Unless the list is a digest-only list you will receive an email for each posting to the list. If you wish to receive a digest version of the list (which could be delayed by a few hours) use the subdigest command instead of subscribe. 
 
@@ -75,4 +80,15 @@ Note that if you have several list aliases, you should unsubscribe from those al
 
 ## List Information
 
-You can request list-specific information with the 'info' command. 
+You can request list-specific information with the 'info' command.
+
+## Test List
+
+After authentication you may post to the list via listname@dragonflybsd.org, like this:
+
+    To: test@dragonflybsd.org 
+    Subject: your_subject_here
+
+    Testing 1 2 3!
+
+Please use the test list for experimentation and remember to unsubscribe from it when you are done (unless you want to see other people's test messages!).  Messages that include HTML sent to any of the lists will be blocked as spam.  Please make sure your messages - including subscription requests - are sent as plain text.