]> code.citadel.org Git - citadel.git/blob - citadel/docs/mailinglists.txt
* Updated the documentation some more
[citadel.git] / citadel / docs / mailinglists.txt
1  Using your Citadel system as a mailing list server (listserv)
2  -------------------------------------------------------------
3  
4  Did you know that Citadel makes a great listserv?  You can turn any room into
5 a mailing list.  Users can then choose how they want to participate -- by
6 logging on to your Citadel, or by having the room's contents mailed to them.
7 It's easy and it's built-in.
8  
9  
10  By default, every room has an e-mail address on the Internet.  The address
11 format is "room_" plus the name of the room, with any spaces replaced by
12 underscores, followed by "@" and your hostname.  For example, if your system
13 is known as "phlargmalb.orc.org" on the Internet, and you have a room called
14 "Bubblegum Collectors", you can post to that room from anywhere on the Internet
15 simply by sending an e-mail to "room_bubblegum_collectors@phlargmalb.orc.org".
16 When the message arrives, it's automatically posted in that room.
17
18
19  Setting up the listserv is very easy, but you do have to do it manually; there
20 are no subscribe/unsubscribe facilities (yet).  Simply go to the room and
21 enter the command <.A>ide <L>ist-management.  Your text editor will open (it's
22 whatever text editor you configured in citadel.rc) and you can simply enter
23 the e-mail addresses of list recipients, one per line.
24  
25  Any messages posted in the room will automatically be mailed out to the
26 recipients on the list, every time the networker runs (by default this is
27 once per hour).