merge some subscribe content from Mailinglists
[ikiwiki.git] / docs / user / mailing_list_commands / index.mdwn
1 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.
2
3 ## For the impatient
4
5 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.
6
7 If you want to test your subscription, use the test@dragonflybsd.org list.
8
9
10 ## Synopsis of BestServ list aliases
11
12       listname - post to the list
13       listname-response - authentication responses sent here
14       listname-request - send subscribe/unsubscribe/etc...
15       listname-command - send moderator command requests
16       listname-errors - (error return for bounces, invisible)
17       listname-owner - send mail to the moderator of the list
18
19       bestserv-owner - moderator of the whole mailing list manager
20       bestserv-errors - (error return for bounces, invisible)
21
22 ## Getting This Help File
23
24 Email a message to the request address of the list. For example, if the list is called 'test', you would email a message to 'test-request@hostname.domain'. On this server, it would be 'test-request@lists.dragonflybsd.org'.
25
26 The body of the message should contain a single line, left justified, containing the keyword 'help' in lower case.
27
28 The list server will generally respond with this help file.
29
30 ##  Authentication
31
32 Many of the requests you make to the list server requires authentication. The list server authenticates a request by emailing a message back to you with a special Subject: line. The message contains complete iunstructions. You normally Reply the message (such that the original Subject is still in the Subject: header, possibly with an Re: in front of it). You must edit the REJECT clause in the Subject line to say ACCEPT if you want to go ahead and run your original command.
33
34 You must be sure to leave the ID clause intact or the list manager will not be able to authenticate your request.
35
36 The purpose of authentication is to ensure that a valid return email address exists and to disuade spammers from crashing the list. The moderator has the ability to turn on authentication AND moderation for any request, so you may not get an immediate response.
37
38 ## Subscribing
39
40 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:
41
42     To: test-request@dragonflybsd.org
43     Subject: blah
44
45     subscribe
46
47 or
48     To: test-request@dragonflybsd.org
49     Subject: blah
50
51     subscribe email-address
52
53 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. 
54
55 ## Third Party Subscribes
56
57 A Third Party Subscribe occurs when person A subscribes person B rather then just himself. This is normally allowed. The list manager will most likely have recipient verification turned on, which means that person B will be sent an email asking him or her to acknowledge the subscription before that person is actually added to the list.
58
59 If you receive a third party verification request and you do not want to be on the list, simply ignore the mail. 
60
61 ## Posting from multiple email addresses
62
63 By default, most lists only allow subscribed addresses to post to the list. You can add other addresses to the list with the 'alias' command.
64
65       alias email-address
66
67 This allows you to post to the list from another email-address without the list distribution being sent to that address. You can add as many aliases as you like. 
68
69 ## Unsubscribing
70
71 To unsubscribe from a list, send the 'unsubscribe' command. You can also unsubscribe third parties by adding an email address.
72
73       unsubscribe
74
75 or
76
77       unsubscribe email-address
78
79 Note that if you have several list aliases, you should unsubscribe from those aliases as well as the one you are receiving the list on. 
80
81 ## List Information
82
83 You can request list-specific information with the 'info' command.
84
85 ## Test List
86
87 After authentication you may post to the list via listname@dragonflybsd.org, like this:
88
89     To: test@dragonflybsd.org 
90     Subject: your_subject_here
91
92     Testing 1 2 3!
93
94 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.