diff options
Diffstat (limited to '')
| -rw-r--r-- | doc/mailman-member.txt | 639 |
1 files changed, 322 insertions, 317 deletions
diff --git a/doc/mailman-member.txt b/doc/mailman-member.txt index 2a795865..c84640ab 100644 --- a/doc/mailman-member.txt +++ b/doc/mailman-member.txt @@ -1,8 +1,9 @@ - #GNU mailman - list Member Manual Contents About this document... About - this document... - Previous Page Up one Level Next Page GNU Mailman - List Member Manual - __________________________________________________________________ + #GNU mailman - list Member Manual Contents About this document... + About this document... + + Previous Page Up one Level Next Page GNU Mailman - List Member Manual + _________________________________________________________________ GNU Mailman - List Member Manual @@ -11,9 +12,9 @@ GNU Mailman - List Member Manual terri(at)zone12.com Release 2.1 - December 5, 2007 + April 21, 2008 - Front Matter + Front Matter Abstract: @@ -58,8 +59,8 @@ Contents + 8 Digests o 8.1 How can I start or stop getting the list posts grouped into one big email? (digest option) - o 8.2 What are MIME and Plain Text Digests? How do I change - which one I get? (digest option) + o 8.2 What are MIME and Plain Text Digests? How do I + change which one I get? (digest option) + 9 Mailing list topics o 9.1 How do I make sure that my post has the right topic? o 9.2 How do I subscribe to all or only some topics on a @@ -79,7 +80,7 @@ Contents + 1 Email commands quick reference + 2 Member options quick reference - 1 Introduction + 1 Introduction This document is intended to help the members of a Mailman 2.1 mailing list learn to use the features available to them. It covers the use of @@ -98,13 +99,13 @@ Contents Note: For the purposes of this document, we assume that the reader is familiar with common terms related to email (eg: Subject line, body of - the message) and web sites (eg: drop-down box, button) or can look them - up. We also assume that the reader can already use his or her email - program and web browser well enough that instructions such as "send - email to this address" or "visit this web page" or "fill in the form - provided" are clear. If you are not familiar with these actions, you - may want to consult other documentation to learn how to do these things - with your particular setup. + the message) and web sites (eg: drop-down box, button) or can look + them up. We also assume that the reader can already use his or her + email program and web browser well enough that instructions such as + "send email to this address" or "visit this web page" or "fill in the + form provided" are clear. If you are not familiar with these actions, + you may want to consult other documentation to learn how to do these + things with your particular setup. 1.1 Acknowledgements @@ -128,16 +129,16 @@ Contents information is being sent. If you were a magazine publisher, you would have a list of the mailing addresses of all the subscribers to the magazine. In the case of an electronic mailing list, we use a list of - email addresses from people interested in hearing about or discussing a - given topic. + email addresses from people interested in hearing about or discussing + a given topic. Two common types of email mailing lists are announcement lists and discussion lists. Announcement lists are are used so that one person or group can send announcements to a group of people, much like a magazine publisher's - mailing list is used to send out magazines. For example, a band may use - a mailing list to let their fan base know about their upcoming + mailing list is used to send out magazines. For example, a band may + use a mailing list to let their fan base know about their upcoming concerts. A discussion list is used to allow a group of people to discuss topics @@ -145,23 +146,23 @@ Contents have it distributed to everyone in the group. This discussion may also be moderated, so only selected posts are sent on to the group as a whole, or only certain people are allowed to send to the group. For - example, a group of model plane enthusiasts might use a mailing list to - share tips about model construction and flying. + example, a group of model plane enthusiasts might use a mailing list + to share tips about model construction and flying. Some common terms: - * A "post" typically denotes a message sent to a mailing list. (Think - of posting a message on a bulletin board.) + * A "post" typically denotes a message sent to a mailing list. + (Think of posting a message on a bulletin board.) * People who are part of an electronic mailing list are usually called the list's "members" or "subscribers." * "List administrators" are the people in charge of maintaining that one list. Lists may have one or more administrators. - * A list may also have people in charge of reading posts and deciding - if they should be sent on to all subscribers. These people are - called list moderators. + * A list may also have people in charge of reading posts and + deciding if they should be sent on to all subscribers. These + people are called list moderators. * Often more than one electronic mailing list will be run using the - same piece of software. The person who maintains the software which - runs the lists is called the "site administrator." Often the site - administrator also administrates individual lists. + same piece of software. The person who maintains the software + which runs the lists is called the "site administrator." Often the + site administrator also administrates individual lists. 1.3 GNU Mailman @@ -189,8 +190,8 @@ Contents typical list address. The capital letters used for the list-specific parts of each address should make it easier to see what should be changed for each list. Although specific list configurations may be - different, you will probably be able to just replace the words given in - capital letters with the appropriate values for a real list: + different, you will probably be able to just replace the words given + in capital letters with the appropriate values for a real list: LISTNAME The name of your list. @@ -199,36 +200,36 @@ Contents The name of the mail server which handles that list. WEBSERVER - The name of the web server which handles the list web interface. - This may be the same as DOMAIN, and often refers to the same - machine, but does not have to be identical. + The name of the web server which handles the list web + interface. This may be the same as DOMAIN, and often refers to + the same machine, but does not have to be identical. As a real-life example, if you are interested in the mailman-users list, you'd make the following substitutions: LISTNAME=mailman-users, DOMAIN=python.org, WEBSERVER=mail.python.org. As such, for the - mailman-users@python.org mailing list, the list information page can be - found at the URL http://mail.python.org/mailman/listinfo/mailman-users. - (These, unlike most of the examples given in this document, are real - addresses.) + mailman-users@python.org mailing list, the list information page can + be found at the URL + http://mail.python.org/mailman/listinfo/mailman-users. (These, unlike + most of the examples given in this document, are real addresses.) Most lists will have this information stored in the List-*: headers. Many mail programs will hide these by default, so you may have to choose to view full headers before you can see these informational headers. - 3 Mailman's interfaces + 3 Mailman's interfaces Mailman has two different interfaces for the list subscriber: the web - interface and the email interface. Most discussion list subscribers use - the email interface, since this includes the email address you use to - send mail to all the subscribers of that list. + interface and the email interface. Most discussion list subscribers + use the email interface, since this includes the email address you use + to send mail to all the subscribers of that list. The interface you use for changing options is largely a matter of preference, since most (but not all) of the options which can be - changed from the web interface can also be changed by email. Usually it - is easier to use the web interface for changing options, since the web - interface provides instructions as you go, but there are times when - people may prefer the email interface, so both are provided. + changed from the web interface can also be changed by email. Usually + it is easier to use the web interface for changing options, since the + web interface provides instructions as you go, but there are times + when people may prefer the email interface, so both are provided. 3.1 The web interface @@ -238,10 +239,10 @@ Contents options do. Every mailing list is also accessible by a number of web pages. Note - that the exact URLs are configurable by the site administrator, so they - may be different than what's described below. We'll describe the most - common configuration, but check with your site administrator or hosting - service for details. + that the exact URLs are configurable by the site administrator, so + they may be different than what's described below. We'll describe the + most common configuration, but check with your site administrator or + hosting service for details. List information (listinfo) page @@ -251,19 +252,19 @@ Contents + The listinfo page is the starting point for the subscriber interface. As one would assume from the name it's given, it contains information about the LISTNAME list. Usually all the - other subscriber pages can be accessed from this point, so you - really only need to know this one address. + other subscriber pages can be accessed from this point, so + you really only need to know this one address. Member options page + Usually found at http://WEBSERVER/mailman/options/LISTNAME/EMAIL (For example, - http://lists.example.com/mailman/options/mylist/kathy@here.com - ) + http://lists.example.com/mailman/options/mylist/kathy@here.co + m) + This page can also be accessed by going to the listinfo page - and entering your email address into the box beside the button - marked "Unsubscribe or Edit Options" (this is near the bottom - of the page). + and entering your email address into the box beside the + button marked "Unsubscribe or Edit Options" (this is near the + bottom of the page). + The member options page allows you to log in/out and change your list settings, as well as unsubscribe or get a copy of your password mailed to you. @@ -284,11 +285,11 @@ Contents http://lists.example.com/pipermail/mylist or http://lists.example.com/mailman/private/mylist) + The list archive pages have copies of the posts sent to the - mailing list, usually grouped by month. In each monthly group, - the posts are usually indexed by author, date, thread, and - subject. - + Note: Pipermail is the name of the default archiver that comes - with Mailman. Other archive programs are available. + mailing list, usually grouped by month. In each monthly + group, the posts are usually indexed by author, date, thread, + and subject. + + Note: Pipermail is the name of the default archiver that + comes with Mailman. Other archive programs are available. + If the archive is private, you will need to supply your subscribed email address and your password to log in. (See Section 6.1 for more information on getting your password.) @@ -298,8 +299,8 @@ Contents Every mailing list has a set of email addresses to which messages can be sent. There's always one address for posting messages to the list, one address to which bounces are sent, and addresses for processing - email commands. For a fictional mailing list called mylist@example.com, - you'd find these addresses: + email commands. For a fictional mailing list called + mylist@example.com, you'd find these addresses: * mylist@example.com - this is the email address people should use for new postings to the list. @@ -310,8 +311,8 @@ Contents * mylist-leave@example.com - by sending a message to this address, a member can request unsubscription from the list. As with the -join address, the Subject: header and body of the message is ignored. - Note that mylist-unsubscribe@example.com is an alias for the -leave - address. + Note that mylist-unsubscribe@example.com is an alias for the + -leave address. * mylist-owner@example.com - This address reaches the list owner and list moderators directly. This is the address you use if you need to contact the person or people in charge. @@ -323,9 +324,10 @@ Contents members whose addresses have become either temporarily or permanently inactive. The -bounces address is also a mail robot that processes bounces and automatically disables or removes - members as configured in the bounce processing settings. Any bounce - messages that are either unrecognized, or do not seem to contain - member addresses, are forwarded to the list administrators. + members as configured in the bounce processing settings. Any + bounce messages that are either unrecognized, or do not seem to + contain member addresses, are forwarded to the list + administrators. * mylist-confirm@example.com - This address is another email robot, which processes confirmation messages for subscription and unsubscription requests. @@ -334,15 +336,15 @@ Contents administrators, but this address only exists for compatibility with older versions of Mailman. - For changing options, we use the LISTNAME-request address (for example, - mylist-request@example.com). + For changing options, we use the LISTNAME-request address (for + example, mylist-request@example.com). Commands can appear in the subject line or the body of the message. Each command should be on a separate line. If your mail program - automatically appends a signature to your messages, you may want to put - the word "end" (without the quotes) on a separate line after your other - commands. The end command tells Mailman not to process the email after - that point. + automatically appends a signature to your messages, you may want to + put the word "end" (without the quotes) on a separate line after your + other commands. The end command tells Mailman not to process the email + after that point. The most important command is probably the "help" command, since it makes Mailman return a message full of useful information about the @@ -352,7 +354,7 @@ Contents Appendices A and B. (These have been slightly adapted from the output of the help command.) - 4 I need to talk to a human! + 4 I need to talk to a human! If you have any trouble with any of these commands, you can always reach the person or people in charge of a list by using the list @@ -373,9 +375,9 @@ Contents 5 Subscribing and unsubscribing - Since subscribing (joining) and unsubscribing (leaving) lists are often - the only things a list member needs to know, these can both be done - without requiring you to know a password. + Since subscribing (joining) and unsubscribing (leaving) lists are + often the only things a list member needs to know, these can both be + done without requiring you to know a password. 5.1 How do I join a list? (subscribe) @@ -394,9 +396,9 @@ Contents Warning: Do NOT use a valuable password, since this password may be mailed to you in plain text. + If the list supports more than one language, you may be able - to choose your preferred language. Note: This setting does not - affect posts to the list, only pre-prepared Mailman texts such - as your member options page. + to choose your preferred language. Note: This setting does + not affect posts to the list, only pre-prepared Mailman texts + such as your member options page. 3. Press the subscribe button. A new page should appear telling you that your request has been sent. @@ -404,29 +406,29 @@ Contents 1. Open a mail program which sends mail from the address you want to subscribe. 2. Send a mail to the list subscription address, which will be in the - form LISTNAME-join@DOMAIN. The subject and body of the message will - be ignored, so it doesn't matter what you put there. + form LISTNAME-join@DOMAIN. The subject and body of the message + will be ignored, so it doesn't matter what you put there. - After following one of these sets of instructions (you don't need to do - both!), there are a few possible outcomes depending upon the settings - for that list. + After following one of these sets of instructions (you don't need to + do both!), there are a few possible outcomes depending upon the + settings for that list. * You may receive an email message asking for confirmation that you - really want to be subscribed to the list. This is to prevent anyone - from subscribing you to lists without your permission. Follow the - instructions given in the message to confirm your wish to be - subscribed. + really want to be subscribed to the list. This is to prevent + anyone from subscribing you to lists without your permission. + Follow the instructions given in the message to confirm your wish + to be subscribed. * A moderator may also need to confirm your subscription if you are subscribing to a limited list. - * Or you may have to wait for a moderator and follow the instructions - in the confirmation mail. + * Or you may have to wait for a moderator and follow the + instructions in the confirmation mail. Once this is done, you will likely receive another message welcoming you to the list. This message contains some useful information including your list password and some quick links for changing your options, so you may want to save it for later reference. - Note: Subscribing can be done in other ways as well. See Appendix A for - more advanced email subscribing commands. + Note: Subscribing can be done in other ways as well. See Appendix A + for more advanced email subscribing commands. 5.2 How do I leave a list? (unsubscribe) @@ -460,28 +462,28 @@ Contents form LISTNAME-leave@DOMAIN. The subject and body of this message will be ignored, so it doesn't matter what you put there. - After following one of these sets of instructions (you don't need to do - both!), you will be sent a confirmation mail and must follow the - instructions given in that mail to complete the unsubscription. This is - to stop people from unsubscribing you without your permission. In + After following one of these sets of instructions (you don't need to + do both!), you will be sent a confirmation mail and must follow the + instructions given in that mail to complete the unsubscription. This + is to stop people from unsubscribing you without your permission. In addition, a moderator may need to approve your unsubscription. If you do not receive this confirmation mail with instructions, make - sure that you typed your email address correctly (if you were using the - web interface to unsubscribe) and that the address you tried to + sure that you typed your email address correctly (if you were using + the web interface to unsubscribe) and that the address you tried to unsubscribe is, indeed, actually subscribed to that list. For security reasons, Mailman generates the same member options page regardless of whether the address entered is subscribed or not. This means that - people cannot use this part of the web interface to find out if someone - is subscribed to the list, but it also means that it's hard to tell if - you just made a typo. + people cannot use this part of the web interface to find out if + someone is subscribed to the list, but it also means that it's hard to + tell if you just made a typo. Once your unsubscription has been processed, you will will probably receive another message confirming your unsubscription from the list, and at that point you should stop receiving messages. - If you wish to skip the confirmation process (for example, you might be - unsubscribing an address which no longer works), it is possible to + If you wish to skip the confirmation process (for example, you might + be unsubscribing an address which no longer works), it is possible to bypass it by using your password instead and either logging in to your options page using it (See Section 3.1), or sending it with your email commands to LISTNAME-request (See Appendix A for advanced email @@ -493,24 +495,24 @@ Contents Your password was either set by you or generated by Mailman when you subscribed. You probably got a copy of it in a welcome message sent when you joined the list, and you may also receive a reminder of it - every month. It is used to verify your identity to Mailman so that only - the holder of the password (you!) and the administrators can view and - change your settings. + every month. It is used to verify your identity to Mailman so that + only the holder of the password (you!) and the administrators can view + and change your settings. Warning: Do NOT use a valuable password for Mailman, since it can be sent in plain text to you. 6.1 How do I get my password? - If you've forgotten your password and haven't saved the welcome message - or any reminder messages, you can always get a reminder through the web - interface: + If you've forgotten your password and haven't saved the welcome + message or any reminder messages, you can always get a reminder + through the web interface: - 1. Go to the list information page for the list from which you wish to - get your password (This will probably be something like + 1. Go to the list information page for the list from which you wish + to get your password (This will probably be something like http://WEBSERVER/mailman/listinfo/LISTNAME) - 2. Look for the section marked "LISTNAME subscribers" (this section is - usually found near the bottom of the page). + 2. Look for the section marked "LISTNAME subscribers" (this section + is usually found near the bottom of the page). 3. There should be a button marked "Unsubscribe or Edit Options." Enter your email address in the box beside this button and press the button. @@ -523,9 +525,9 @@ Contents address you used is, indeed, actually subscribed to that list. For security reasons, Mailman generates the same member options page regardless of whether the address entered is subscribed or not. This - means that people cannot use this part of the web interface to find out - if someone is subscribed to the list, but it also means that it's hard - to tell if you just made a typo. + means that people cannot use this part of the web interface to find + out if someone is subscribed to the list, but it also means that it's + hard to tell if you just made a typo. You can also get a reminder using the email interface, 1. Send a mail to LISTNAME-request@DOMAIN with the command password @@ -533,8 +535,8 @@ Contents message. (See Section 3.2 for more information about sending mail commands.) If you are not sending mail from your subscribed address, you can - also specify this address by sending the command password address= - $<$ ADDRESS $>$ . + also specify this address by sending the command + password address=ADDRESS. 6.2 How do I change my password? @@ -548,31 +550,30 @@ Contents page and enter your new password in the appropriate boxes, then press the button marked "Change My Password." - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. From the email interface: - 1. Send a mail to LISTNAME-request@DOMAIN with the command password - $<$ OLDPASSWORD $>$ $<$ NEWPASSWORD $>$ . + 1. Send a mail to LISTNAME-request@DOMAIN with the command + password OLDPASSWORD NEWPASSWORD. Commands can appear in either the body or the subject of the message. (See Section 3.2 for more information about sending mail commands.) If you are not sending mail from your membership address, you can - also specify this address with address= $<$ ADDRESS $>$ after $<$ - NEWPASSWORD $>$ . - For example, if kathy@here.com wanted to change her mylist password - from zirc to miko, but she was sending mail from her work address - kathy@work.com, she could send a message to + also specify this address with address=ADDRESS after NEWPASSWORD. + For example, if kathy@here.com wanted to change her mylist + password from zirc to miko, but she was sending mail from her work + address kathy@work.com, she could send a message to mylist-request@example.com with the subject set to password zirc miko address=kathy@here.com. 6.3 How do I turn password reminders on or off? (reminders option) If you don't wish to the reminder email including your password every - month, you can disable it from the member options page. (You can always - get the password mailed out when you actually want it. See Section 6.1 - for instructions.) + month, you can disable it from the member options page. (You can + always get the password mailed out when you actually want it. See + Section 6.1 for instructions.) Using the web interface: 1. Log in to your member options page. (See Section 3.1 for @@ -580,9 +581,9 @@ Contents 2. Look for the section marked "Get password reminder email for this list?" and change the value accordingly. - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. Using the email interface: 1. Send a mail to LISTNAME-request@DOMAIN with the command @@ -593,35 +594,36 @@ Contents 2. Set it to "on" to receive reminders, and "off" to stop receiving reminders. - 7 Changing mail delivery + 7 Changing mail delivery 7.1 How do I turn mail delivery on or off? (delivery option) - You may wish to temporarily stop getting messages from the list without - having to unsubscribe. If you disable mail delivery, you will no longer - receive messages, but will still be a subscriber and will retain your - password and other settings. + You may wish to temporarily stop getting messages from the list + without having to unsubscribe. If you disable mail delivery, you will + no longer receive messages, but will still be a subscriber and will + retain your password and other settings. This can be handy in a many different cases. For example, you could be - going on vacation or need a break from the list because you're too busy - to read any extra mail. Many mailing lists also allow only subscribers - to post to the list, so if you commonly send mail from more than one - address (eg, one address for at home and another for when you're - travelling), you may want to have more than one subscribed account, but - have only one of them actually receive mail. You can also use this as a - way to read private archives even on a list which may be too busy for - you to have sent directly to your mailbox. All you need to do is - subscribe, disable mail delivery, and use your password and email to - log in to the archives. + going on vacation or need a break from the list because you're too + busy to read any extra mail. Many mailing lists also allow only + subscribers to post to the list, so if you commonly send mail from + more than one address (eg, one address for at home and another for + when you're travelling), you may want to have more than one subscribed + account, but have only one of them actually receive mail. You can also + use this as a way to read private archives even on a list which may be + too busy for you to have sent directly to your mailbox. All you need + to do is subscribe, disable mail delivery, and use your password and + email to log in to the archives. To disable/enable mail delivery using the web interface: 1. Log in to your options page. (See Section 3.1 for instructions.) - 2. Go down to the section marked "Mail delivery" and select "Disabled" - to stop receiving mail, and "Enabled" to start receiving mail. + 2. Go down to the section marked "Mail delivery" and select + "Disabled" to stop receiving mail, and "Enabled" to start + receiving mail. - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. To disable/enable mail delivery using the email interface: 1. Send a mail to LISTNAME-request@DOMAIN with the command @@ -648,9 +650,9 @@ Contents 2. Scroll down to the bottom of the page to the section marked "Avoid duplicate copies of messages?" and change the value accordingly. - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. To turn this on or off using the email interface: 1. Send a mail to LISTNAME-request@DOMAIN with the command @@ -671,8 +673,8 @@ Contents 3. If you wish to change your address for all subscriptions using the old address, select the "Change globally" box. If you have subscriptions under another address or for lists on a different - domain, these will have to be done separately. See Section 10.1 for - more information about changing settings globally. + domain, these will have to be done separately. See Section 10.1 + for more information about changing settings globally. There is no special way to do this from the email interface, but you can subscribe and unsubscribe for more or less the same effect. (See @@ -708,8 +710,8 @@ Contents 2. Set it to "on" to receive copies of your own posts, and "off" to avoid receiving them. -7.5 How can I get Mailman to tell me when my post has been received by the list? -(ack option) +7.5 How can I get Mailman to tell me when my post has been received by the +list? (ack option) On most lists, you will simply receive a copy of your mail when it has gone through the list software, but if this is disabled (See @@ -746,12 +748,12 @@ Contents There are a few common reasons for this: * No one has sent any mail to the list(s) you're on for a little while. - To check if this is the case, try visiting the archives of the list - (assuming that the list has archives). If the list has no archives, - you may have to ask another subscriber. (See Section 3.1 for help - in finding the list archives.) - Note: Generally, it is considered impolite to send test messages to - the entire list. If you feel a need to test that the list is + To check if this is the case, try visiting the archives of the + list (assuming that the list has archives). If the list has no + archives, you may have to ask another subscriber. (See Section 3.1 + for help in finding the list archives.) + Note: Generally, it is considered impolite to send test messages + to the entire list. If you feel a need to test that the list is working and for some reason you cannot simply compose a regular message to the list, it is less disruptive to send a help message to the list request address (LISTNAME-request@DOMAIN) to see if @@ -766,8 +768,9 @@ Contents example, the subscriber has found a new internet service provider and forgot to unsubscribe the old address), as well as addresses which are temporarily out-of-service (for example, the subscriber - has used up all of the allotted space for his or her email account, - or the subscriber's mail provider is experiencing difficulties). + has used up all of the allotted space for his or her email + account, or the subscriber's mail provider is experiencing + difficulties). Even if you are unaware of any difficulties with your mail provider, it is a good idea to check this. Some popular webmail providers and internet servers are not as reliable as one might @@ -781,9 +784,9 @@ Contents marked "Mail Delivery" - if it is set to "Disabled," set it to "Enabled" to start receiving mail again. (For more instructions on disabling or enabling mail delivery, see Section 7.1.) - Note: Even if you have not been disabled at the time you check, you - could be bouncing messages and not have reached the threshold for - your subscription to be disabled. You may need to check again. + Note: Even if you have not been disabled at the time you check, + you could be bouncing messages and not have reached the threshold + for your subscription to be disabled. You may need to check again. * There is a delay or break in the networks between you and the list server. No matter what many of us would like, the internet is not 100% @@ -791,8 +794,8 @@ Contents long time to get to you. Try to be patient, especially if the server is far (in terms of networks, not geography, although often one implies the other) from your internet service provider. - To check if this might be causing your problem, you can try pinging - the list server or tracing the route between you and it. + To check if this might be causing your problem, you can try + pinging the list server or tracing the route between you and it. (Instructions on how to do this varies from platform to platform, so you may want to use a search engine to find those appropriate for you.) @@ -815,15 +818,15 @@ Contents moderately busy list, this typically means you get one email per day, although it may be more or less frequent depending upon the list. - You may also want to look at Section 8.2 which discusses MIME and plain - text digests. + You may also want to look at Section 8.2 which discusses MIME and + plain text digests. To turn digest mode on or off using the web interface, 1. Log in to your member options page. (See Section 3.1 for more details on how to do this.) 2. Look for the section marked "Set Digest Mode." - Set it to "On" to receive messages bundled together in digests. Set - it to "Off" to receive posts separately. + Set it to "On" to receive messages bundled together in digests. + Set it to "Off" to receive posts separately. To turn digest mode on or off using the email interface, 1. Send a mail to LISTNAME-request@DOMAIN with the command @@ -831,10 +834,10 @@ Contents Commands can appear in either the body or the subject of the message. (See Section 3.2 for more information about sending mail commands.) - 2. Set it to "off" if you wish to receive individual posts separately, - and to "plain" or "mime" to receive posts grouped into one large - mail. See Section 8.2 for more information on plain versus MIME - digests. + 2. Set it to "off" if you wish to receive individual posts + separately, and to "plain" or "mime" to receive posts grouped into + one large mail. See Section 8.2 for more information on plain + versus MIME digests. 8.2 What are MIME and Plain Text Digests? How do I change which one I get? (digest option) @@ -862,12 +865,12 @@ Contents 1. Log in to your member options page. (See Section 3.1 for more details on how to do this.) 2. Look for the section marked "Get MIME or Plain Text Digests?." - Set it to "MIME" to receive digests in MIME format, or "Plain text" - to receive digests in plain text format. + Set it to "MIME" to receive digests in MIME format, or "Plain + text" to receive digests in plain text format. - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. To set your digest type using the email interface, 1. Send a mail to LISTNAME-request@DOMAIN with the command @@ -875,18 +878,18 @@ Contents Commands can appear in either the body or the subject of the message. (See Section 3.2 for more information about sending mail commands.) - 2. Set it to "plain" to get posts bundled into a plain text digest, or - "mime" to get posts bundled together into a MIME digest. + 2. Set it to "plain" to get posts bundled into a plain text digest, + or "mime" to get posts bundled together into a MIME digest. 9 Mailing list topics Some lists are set up so that different topics are handled by Mailman. - For example, the courses list on Linuxchix.org is a discussion list for - courses being run by linuxchix members, and often there are several - courses being run at the same time. (eg: Networking for beginners, C - programming, LaTeX document mark up.) Each of the courses being run is - a separate topic on the list so that people can choose only to receive - the course they want to take. + For example, the courses list on Linuxchix.org is a discussion list + for courses being run by linuxchix members, and often there are + several courses being run at the same time. (eg: Networking for + beginners, C programming, LaTeX document mark up.) Each of the courses + being run is a separate topic on the list so that people can choose + only to receive the course they want to take. These topics must be configured by the list administrator, but it is the responsibility of each poster to make sure that their post is put @@ -899,7 +902,8 @@ Contents 9.1 How do I make sure that my post has the right topic? - When a list administrator defines a topic, he or she sets three things: + When a list administrator defines a topic, he or she sets three + things: * a topic name * a regular expression (regexp) * a description @@ -925,29 +929,29 @@ Contents Here are some examples of possible regular expressions and matching lines: -Regular expression Matching lines -zuff Keywords: zuff -zuff Keywords: ZUFF -zuff Keywords: Zuff -zuff Keywords: amaryllis, zuff, applesauce -zuff Subject: [zuff] Do you have the right stuff for zuff? -zuff Subject: Do you have the right stuff for zuff? -zuff Subject: What is zuff? -\[zuff\] Keywords: [zuff] -\[zuff\] Subject: [zuff] Do you have the right stuff? -\[zuff\] Subject: Online zuff tutorials (was Re: [zuff] What is zuff?) + Regular expression Matching lines + zuff Keywords: zuff + zuff Keywords: ZUFF + zuff Keywords: Zuff + zuff Keywords: amaryllis, zuff, applesauce + zuff Subject: [zuff] Do you have the right stuff for zuff? + zuff Subject: Do you have the right stuff for zuff? + zuff Subject: What is zuff? + \[zuff\] Keywords: [zuff] + \[zuff\] Subject: [zuff] Do you have the right stuff? + \[zuff\] Subject: Online zuff tutorials (was Re: [zuff] What is zuff?) A few notes: - * The matching is case-insensitive, so if zuff matches, so will ZUFF, - zuFF, and any other variations in capitalization. - * Some characters have special meaning in a regular expression, so to - match those characters specifically, they must be "escaped" with a - backslash (\). As you can see in the above example, [ and ] are - such characters. (Others include ".", "?", and "*"). The backslash - is also used for other things (I wasn't kidding about regular - expressions being complex: consult other documentation for details - about other uses of the backslash character), but this is the most - likely use in a topic expression. + * The matching is case-insensitive, so if zuff matches, so will + ZUFF, zuFF, and any other variations in capitalization. + * Some characters have special meaning in a regular expression, so + to match those characters specifically, they must be "escaped" + with a backslash (\). As you can see in the above example, [ and ] + are such characters. (Others include ".", "?", and "*"). The + backslash is also used for other things (I wasn't kidding about + regular expressions being complex: consult other documentation for + details about other uses of the backslash character), but this is + the most likely use in a topic expression. 9.2 How do I subscribe to all or only some topics on a list? @@ -955,24 +959,24 @@ zuff Subject: What is zuff? choose to subscribe to only part of a list by selecting the topics you want to receive. - If you wish to get all messages sent to the list, make sure you are not - subscribed to any topics. + If you wish to get all messages sent to the list, make sure you are + not subscribed to any topics. 1. Log in to your member options page. (See Section 3.1 for more details on how to do this.) 2. Look for the section marked "Which topic categories would you like to subscribe to?" - If any topics are defined, you can select those you wish. If you do - not select any topics of interest, you will receive all posts sent - to the list. + If any topics are defined, you can select those you wish. If you + do not select any topics of interest, you will receive all posts + sent to the list. You probably also want to look at Section 9.3 which discusses changing your settings for messages where no topic is set. 9.3 How do I get or avoid getting messages with no topic set? - If you wish to get all messages sent to the list, make sure you are not - subscribed to any specific topic. (See Section 9.2.) + If you wish to get all messages sent to the list, make sure you are + not subscribed to any specific topic. (See Section 9.2.) If you are only subscribed to some topics, you can either choose to either receive or not receive messages with no topic set, much the way @@ -981,24 +985,24 @@ zuff Subject: What is zuff? To change this setting, 1. Log in to your member options page. (See Section 3.1 for more details on how to do this.) - 2. Look for the section marked "Do you want to receive message that do - not match any topic filter?" - If you wish to receive messages with no topic set, select "Yes." If - you do not wish to receive such messages, choose "No." + 2. Look for the section marked "Do you want to receive message that + do not match any topic filter?" + If you wish to receive messages with no topic set, select "Yes." + If you do not wish to receive such messages, choose "No." This setting has no effect if you are not subscribed to any topics. - 10 Setting other options + 10 Setting other options 10.1 Change Globally? Set Globally? What does that mean? For some of the options given in your member options page, there is a tick-box which says "Change Globally" or "Set Globally." This means that if you change this option, you can also have the change made for - all your other list subscriptions with the same address to lists on the - same domain. This can be handy if, for example, you want to make sure - all your passwords are the same, or you are going on vacation and want - to turn off mail delivery from all the lists. + all your other list subscriptions with the same address to lists on + the same domain. This can be handy if, for example, you want to make + sure all your passwords are the same, or you are going on vacation and + want to turn off mail delivery from all the lists. 10.2 How do I change my name as Mailman knows it? @@ -1008,26 +1012,26 @@ zuff Subject: What is zuff? 2. In the section marked "Changing your LISTNAME membership information," enter your new name in the appropriate box. - This can also be changed for multiple lists at the same time if you are - subscribed to more than one list on the same domain. See Section 10.1 - for information about changing settings globally. + This can also be changed for multiple lists at the same time if you + are subscribed to more than one list on the same domain. See + Section 10.1 for information about changing settings globally. Note: You do not need to have a subscription name set. 10.3 How do I set my preferred language? Mailman is available with many different languages. (For a complete - listing see http://mailman.sourceforge.net/i18n.html.) This means that, - if your list has other languages enabled, you may be able to have the - web interface, etc. in a language of your choice. + listing see http://mailman.sourceforge.net/i18n.html.) This means + that, if your list has other languages enabled, you may be able to + have the web interface, etc. in a language of your choice. Note: This does NOT necessarily mean that all the posts sent to the list will be in the language you selected. Only the pre-prepared texts presented by Mailman will be affected by this setting. Posts are in whatever language the poster uses. - Your preferred language is set when you subscribe (see Section5.1), and - can be changed later if the list supports more than one language. + Your preferred language is set when you subscribe (see Section5.1), + and can be changed later if the list supports more than one language. To change your preferred language in Mailman, 1. Log in to your member options page. (See Section 3.1 for @@ -1037,33 +1041,34 @@ zuff Subject: What is zuff? drop-down list of languages, the list you are on probably only supports one language. - If your list does not support the language you would prefer to use, you - may contact the list administrator (LISTNAME-owner@DOMAIN) to see if it - can be added, but remember that this may mean some work that the list - and/or site administrator(s) do not have time or the ability to do. + If your list does not support the language you would prefer to use, + you may contact the list administrator (LISTNAME-owner@DOMAIN) to see + if it can be added, but remember that this may mean some work that the + list and/or site administrator(s) do not have time or the ability to + do. If your language of choice is not available because no translation exists for Mailman, please consider volunteering your time as a translator. For more information you may want to consult the mailman-i18n mailing list at - http://mail.python.org/mailman/listinfo/mailman-i18n. (i18n is a common - short-hand for "internationalization" because the word starts with an - i, ends with an n, and has 18 letters in between. If you mumble a bit, - i18n even sounds a bit like "internationalization.") + http://mail.python.org/mailman/listinfo/mailman-i18n. (i18n is a + common short-hand for "internationalization" because the word starts + with an i, ends with an n, and has 18 letters in between. If you + mumble a bit, i18n even sounds a bit like "internationalization.") 10.4 How do I avoid having my name appear on the subscribers list? (the hide option) - If you do not want to have your email address show up on the subscriber - list for any reason, you can opt to have it concealed. + If you do not want to have your email address show up on the + subscriber list for any reason, you can opt to have it concealed. Common reasons for doing this include avoiding unsolicited bulk email (spam). By default, the subscribers list is obscured to hinder spam harvesters, but if you feel this is insufficient it's easy enough to remove address from the subscriber list given in the information pages - or by email request. (Note that this does not conceal your address from - the list administrators.) You may wish to see Section 11.2 for more - information on what Mailman can do to help avoid spam. + or by email request. (Note that this does not conceal your address + from the list administrators.) You may wish to see Section 11.2 for + more information on what Mailman can do to help avoid spam. To change this setting using the web interface: 1. Log in to your member options page. (See Section 3.1 for @@ -1073,8 +1078,8 @@ option) your name to appear on the list. To change this setting using the email interface: - 1. Send a mail to LISTNAME-request@DOMAIN with the command set hide on - or set hide off. + 1. Send a mail to LISTNAME-request@DOMAIN with the command + set hide on or set hide off. Commands can appear in either the body or the subject of the message. (See Section 3.2 for more information about sending mail commands.) @@ -1086,12 +1091,12 @@ option) 11.1 How do I view the list archives? If the list has archives, they can be viewed by going to a web page - address. This address usually linked from the list information page and - can be found in the List-Archive: of every list message unless your - list administrator has disabled these headers. (Many mail programs hide - the List-Archive: mail header, so you may have to tell your mail - program to allow you to view full headers before you will be able to - see it.) + address. This address usually linked from the list information page + and can be found in the List-Archive: of every list message unless + your list administrator has disabled these headers. (Many mail + programs hide the List-Archive: mail header, so you may have to tell + your mail program to allow you to view full headers before you will be + able to see it.) Public archives usually have addresses of the form http://WEBSERVER/pipermail/LISTNAME/ and private archives usually have @@ -1100,31 +1105,33 @@ option) See Section 3.1 for more information on finding the addresses of a list. -11.2 What does Mailman do to help protect me from unsolicited bulk email (spam)? +11.2 What does Mailman do to help protect me from unsolicited bulk email +(spam)? - A technical list's archives may include answers to a range of different - questions. Often, the people who have posted these answers would be - happy to help someone who doesn't quite understand the answer, and - don't mind giving their address out for that purpose. But although it - would be wonderful if everyone could contact each other easily, we also - want to make sure that the list and list archives are not abused by - people who send spam. + A technical list's archives may include answers to a range of + different questions. Often, the people who have posted these answers + would be happy to help someone who doesn't quite understand the + answer, and don't mind giving their address out for that purpose. But + although it would be wonderful if everyone could contact each other + easily, we also want to make sure that the list and list archives are + not abused by people who send spam. To make a range of options available to list administrators, Mailman allows a variety of configurations to help protect email addresses. Many of these settings are optional to the list administrator, so your particular list may be set up in many ways. List administrators must - walk a fine line between protecting subscribers and making it difficult - for people to get in touch. + walk a fine line between protecting subscribers and making it + difficult for people to get in touch. * Subscriber lists + The list administrator can choose to have the subscriber list public, viewable only to list members, or viewable only to list administrators. + The subscriber list is shown with the addresses obscured to - make it difficult for spam harvesters to collect your address. - + You can choose to have your address hidden from the subscriber - list. (See Section 10.4 for more information.) + make it difficult for spam harvesters to collect your + address. + + You can choose to have your address hidden from the + subscriber list. (See Section 10.4 for more information.) + Note: The entire subscriber list is always available to the list administrators. * List archives @@ -1143,8 +1150,8 @@ option) * Limited posting to the lists + The list administrator can choose who can post to the list. Most lists are either moderated (a moderator or administrator - reviews each posting), set so only subscribers may post to the - list, or allow anyone to post to the list. + reviews each posting), set so only subscribers may post to + the list, or allow anyone to post to the list. + By allowing only subscribers to post to a list, Mailman often blocks all spam and some viruses from being sent through the list. As such, this is a fairly common setting used by list @@ -1160,9 +1167,9 @@ option) determined people, so be aware that the protections used may not be enough. - 1 Email commands quick reference + 1 Email commands quick reference - * confirm $<$ CONFIRMATION-STRING $>$ + * confirm CONFIRMATION-STRING + Confirm an action. The confirmation-string is required and should be supplied within a mailback confirmation notice. * end @@ -1175,59 +1182,57 @@ option) * lists + See a list of the public mailing lists on this GNU Mailman server. - * password [ $<$ OLDPASSWORD $>$ $<$ NEWPASSWORD $>$ ] [address= $<$ - ADDRESS $>$ ] + * password [OLDPASSWORD NEWPASSWORD] [address=ADDRESS] + Retrieve or change your password. With no arguments, this - returns your current password. With arguments $<$ OLDPASSWORD - $>$ and $<$ NEWPASSWORD $>$ you can change your password. + returns your current password. With arguments OLDPASSWORD and + NEWPASSWORD you can change your password. * set ... + Set or view your membership options. Use `set help' (without the quotes) to get a more detailed - list of the options you can change. This list is also given in - Appendix B. + list of the options you can change. This list is also given + in Appendix B. Use `set show' (without the quotes) to view your current option settings. - * subscribe [ $<$ PASSWORD $>$ ] [digest|nodigest] [address= $<$ - ADDRESS $>$ ] - + Subscribe to this mailing list. Your password must be given to - unsubscribe or change your options, but if you omit the + * subscribe [PASSWORD] [digest|nodigest] [address=ADDRESS] + + Subscribe to this mailing list. Your password must be given + to unsubscribe or change your options, but if you omit the password, one will be generated for you. You may be periodically reminded of your password. The next argument may be either: `nodigest' or `digest' (no quotes!). If you wish to subscribe an address other than the - address you sent this request from, you may specify `address= - $<$ ADDRESS $>$ ' (no brackets around the email address, and + address you sent this request from, you may specify + `address=ADDRESS' (no brackets around the email address, and no quotes!) - * unsubscribe [ $<$ PASSWORD $>$ ] [address= $<$ ADDRESS $>$ ] + * unsubscribe [PASSWORD] [address=ADDRESS] + Unsubscribe from the mailing list. If given, your password must match your current password. If omitted, a confirmation email will be sent to the unsubscribing address. If you wish - to unsubscribe an address other than the address you sent this - request from, you may specify `address= $<$ ADDRESS $>$ ' (no + to unsubscribe an address other than the address you sent + this request from, you may specify `address=ADDRESS' (no brackets around the email address, and no quotes!) - * who [ $<$ PASSWORD $>$ ] [address= $<$ ADDRESS $>$ ] + * who [PASSWORD] [address=ADDRESS] + See everyone who is on this mailing list. The roster is limited to list members only, and you must supply your membership password to retrieve it. If you're posting from an address other than your membership address, specify your - membership address with `address= $<$ ADDRESS $>$ ' (no - brackets around the email address, and no quotes!) + membership address with `address=ADDRESS' (no brackets around + the email address, and no quotes!) - 2 Member options quick reference + 2 Member options quick reference * set help + Show this detailed help. - * set show [address= $<$ ADDRESS $>$ ] + * set show [address=ADDRESS] + View your current option settings. If you're posting from an address other than your membership address, specify your - membership address with `address= $<$ ADDRESS $>$ ' (no - brackets around the email address, and no quotes!). - * set authenticate $<$ PASSWORD $>$ [address= $<$ ADDRESS $>$ ] + membership address with `address=ADDRESS' (no brackets around + the email address, and no quotes!). + * set authenticate PASSWORD [address=ADDRESS] + To set any of your options, you must include this command first, along with your membership password. If you're posting from an address other than your membership address, specify - your membership address with `address= $<$ ADDRESS $>$ ' (no - brackets around the email address, and no quotes!). + your membership address with `address=ADDRESS' (no brackets + around the email address, and no quotes!). * set ack on set ack off + When the `ack' option is turned on, you will receive an @@ -1240,8 +1245,8 @@ option) postings immediately when they are posted. Use `set digest plain' if instead you want to receive postings bundled into a plain text digest (i.e. RFC 1153 digest). Use `set digest - mime' if instead you want to receive postings bundled together - into a MIME digest. + mime' if instead you want to receive postings bundled + together into a MIME digest. * set delivery on set delivery off + Turn delivery on or off. This does not unsubscribe you, but @@ -1260,8 +1265,8 @@ option) * set duplicates on set duplicates off + Use `set duplicates off' if you want Mailman not to send you - messages if your address is explicitly mentioned in the To: or - Cc: fields of the message. This can reduce the number of + messages if your address is explicitly mentioned in the To: + or Cc: fields of the message. This can reduce the number of duplicate postings you will receive. * set reminders on set reminders off @@ -1270,7 +1275,7 @@ option) About this document ... - GNU Mailman - List Member Manual, December 5, 2007, Release 2.1 + GNU Mailman - List Member Manual, April 21, 2008, Release 2.1 This document was generated using the LaTeX2HTML translator. @@ -1282,9 +1287,9 @@ option) The application of LaTeX2HTML to the Python documentation has been heavily tailored by Fred L. Drake, Jr. Original navigation icons were contributed by Christopher Petrilli. - __________________________________________________________________ + _________________________________________________________________ - Previous Page Up one Level Next Page GNU Mailman - List Member Manual - __________________________________________________________________ + Previous Page Up one Level Next Page GNU Mailman - List Member Manual + _________________________________________________________________ - Release 2.1, documentation updated on December 5, 2007. + Release 2.1, documentation updated on April 21, 2008. |