1
% Complete documentation on the extended LaTeX mark up used for Python
2
% documentation is available in ``Documenting Python'', which is part
3
% of the standard documentation for Python. It may be found online
6
% http://www.python.org/doc/current/doc/doc.html
10
% This is a template for short or medium-size Python-related documents,
11
% mostly notably the series of HOWTOs, but it can be used for any
14
% The title should be descriptive enough for people to be able to find
15
% the relevant document.
16
\title{GNU Mailman - List Member Manual}
18
% Increment the release number whenever significant changes are made.
19
% The author and/or editor can define 'significant' however they like.
22
% 0.03 Proofreading changes
23
% 0.02 Proofreading changes
24
% - proofread by Margaret McCarthy and Jason Walton
25
% 0.01 First draft of document
27
% At minimum, give your name and an email address. You can include a
28
% snail-mail address if you like.
30
\authoraddress{terri(at)zone12.com}
32
\date{\today} % XXX update before tagging release!
33
\release{2.1} % software release, not documentation
34
\setreleaseinfo{} % empty for final release
35
\setshortversion{2.1} % major.minor only for software
40
% This makes the Abstract go on a separate page in the HTML version;
41
% if a copyright notice is used, it should go immediately after this.
44
\chapter*{Front Matter\label{front}}
47
% Copyright statement should go here, if needed.
50
% The abstract should be a paragraph or two long, and describe the
51
% scope of the document.
54
This document describes the list member interface for GNU
55
Mailman 2.1. It contains instructions for subscribing, unsubscribing,
56
viewing the archives, editing user options, getting password reminders,
57
and other subscriber-level tasks. It also answers some common questions
58
of interest to Mailman list members.
63
% ============================================================================
64
\section{Introduction}
66
This document is intended to help the members of a Mailman 2.1 mailing list
67
learn to use the features available to them. It covers the use of the
68
web and email interfaces for subscribing and unsubscribing, changing
69
member options, getting password reminders and other subscriber-level
70
tasks. It also answers some common questions of interest to Mailman list
73
Information for list and site administrators is provided in
76
This document need not be read in order. If you are simply looking for
77
an answer to a specific question, jump to the appropriate place and
78
references to other sections will be provided if necessary or potentially
81
\note{For the purposes of this document,
82
we assume that the reader is familiar with common terms related to email (eg:
83
Subject line, body of the message) and web sites (eg: drop-down box, button) or
84
can look them up. We also assume that the reader can already use his or her
85
email program and web browser well enough that instructions such as "send email
86
to this address" or "visit this web page" or "fill in the form provided" are
87
clear. If you are not familiar with these actions, you may want to consult
88
other documentation to learn how to do these things with your particular
91
% ----------------------------------------------------------------------------
92
\subsection{Acknowledgements}
94
Sections of this document have been borrowed from the List Administrator Manual
95
found in Mailman CVS, which was written by Barry A. Warsaw, and from the in-line
98
The rest of this manual has been written by Terri Oda.
99
Terri has been maintaining mailing lists since the year she attained
100
voting age in Canada, although the two are not related. She currently
101
oversees the mailing lists at Linuxchix.org, as well as several smaller
102
servers. In the world outside of list administration, Terri is doing
103
work with an artificial life spam detector, and is actually more of a
104
programmer than technical writer.
106
Proofreading thanks go to Margaret McCarthy and Jason Walton.
108
%WRITEME: More here. Do we need a license statement here?
110
% ----------------------------------------------------------------------------
111
\subsection{What is a mailing list?}
113
A mailing list is simply a list of addresses to which the same information
114
is being sent. If you were a magazine publisher, you would have a list of
115
the mailing addresses of all the subscribers to the magazine. In the case
116
of an electronic mailing list, we use a list of email addresses from people
117
interested in hearing about or discussing a given topic.
119
Two common types of email mailing lists are announcement lists and discussion
122
Announcement lists are are used so that one person or group can send
123
announcements to a group of people, much like a magazine publisher's mailing
124
list is used to send out magazines. For example, a band may use a mailing list
125
to let their fan base know about their upcoming concerts.
128
A discussion list is used to allow a group of people to discuss topics amongst
129
themselves, with everyone able to send mail to the list and have it distributed
130
to everyone in the group. This discussion may also be moderated, so only
131
selected posts are sent on to the group as a whole, or only certain people are
132
allowed to send to the group. For example, a group of model plane enthusiasts
133
might use a mailing list to share tips about model construction and flying.
137
\item A "post" typically denotes a message sent to a mailing list.
138
(Think of posting a message on a bulletin board.)
139
\item People who are part of an electronic mailing list are usually called
140
the list's "members" or "subscribers."
141
\item "List administrators" are the people in charge of maintaining that
142
one list. Lists may have one or more administrators.
143
\item A list may also have people in charge of reading posts and deciding
144
if they should be sent on to all subscribers. These people are called
146
\item Often more than one electronic mailing list will be run using the same
147
piece of software. The person who maintains the software which runs
148
the lists is called the "site administrator." Often the site administrator
149
also administrates individual lists.
151
% ----------------------------------------------------------------------------
152
\subsection{GNU Mailman}
154
GNU Mailman is software that lets you manage electronic mailing lists. It
155
supports a wide range of mailing list types, such as general discussion
156
lists and announce-only lists. Mailman has extensive features which make it
157
good for list subscribers, such as easy subscription and unsubscription,
158
privacy options, and the ability to temporarily stop getting posts from the
159
list. The list member features are covered in this document.
161
Mailman also has many features which make it attractive to list and site
162
administrators. These features are covered in the list and site administrator
165
% ============================================================================
166
\section{Translating from our examples to real lists}
168
Often, it's easier to simply give an example than explain exactly how
169
to find the address for your specific list. As such, we'll frequently
170
give examples for a fictional list called
171
\email{LISTNAME@DOMAIN} whose list information page can be found at
172
\url{http://WEBSERVER/mailman/listinfo/LISTNAME}.
175
real addresses, but they show the form of a typical list address.
176
The capital letters used for the list-specific parts of each address should
177
make it easier to see what should be changed for each
178
list. Although specific list configurations may be different, you will
179
probably be able to just replace the words given in capital letters with the
180
appropriate values for a real list:
183
\item [LISTNAME] The name of your list.
184
\item [DOMAIN] The name of the mail server which handles that list.
185
\item [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.
188
As a real-life example, if you are interested in the mailman-users list, you'd
189
make the following substitutions: LISTNAME=mailman-users, DOMAIN=python.org, WEBSERVER=mail.python.org. As such, for the
190
\email{mailman-users@python.org}
191
mailing list, the list information page can be found at the URL
192
\url{http://mail.python.org/mailman/listinfo/mailman-users}. (These, unlike
193
most of the examples given in this document, are real addresses.)
195
Most lists will have this information stored in the \mailheader{List-*}
197
mail programs will hide these by default, so you may have to choose to view
198
full headers before you can see these informational headers.
200
% ============================================================================
201
\section{Mailman's interfaces}
202
Mailman has two different interfaces for the list subscriber: the web
203
interface and the email interface. Most discussion list subscribers use
204
the email interface, since this includes the email address you use to send
205
mail to all the subscribers of that list.
207
The interface you use for changing options is largely
208
a matter of preference, since most (but not all) of the options which can
209
be changed from the web interface can also be changed by email.
210
Usually it is easier to use the web interface for
211
changing options, since the web interface provides instructions as you go, but
212
there are times when people may prefer the email interface, so both are
215
% ----------------------------------------------------------------------------
216
\subsection{The web interface\label{sec:web}}
217
The web interface of Mailman is its selling point for many administrators,
218
since it makes it much easier for subscribers and administrators to see
219
which options are available, and what these options do.
221
Every mailing list is also accessible by a number of web pages. Note that
222
the exact URLs are configurable by the site administrator, so they may be
223
different than what's described below. We'll describe the most common
224
configuration, but check with your site administrator or hosting
228
\item [List information (listinfo) page]
230
\item Usually found at \url{http://WEBSERVER/mailman/listinfo/LISTNAME}
231
(for example, \url{http://lists.example.com/mailman/listinfo/mylist})
233
\item The listinfo page is the starting point for the subscriber
234
interface. As one would assume from the name it's given, it
235
contains information about the LISTNAME list.
236
Usually all the other subscriber pages can be accessed from this
237
point, so you really only need to know this one address.
241
\item [Member options page]
243
\item Usually found at \url{http://WEBSERVER/mailman/options/LISTNAME/EMAIL}
244
(For example, \url{http://lists.example.com/mailman/options/mylist/kathy@here.com})
246
\item This page can also be accessed by going to the listinfo page
247
and entering your email address into the box beside the button
248
marked "Unsubscribe or Edit Options" (this is near the bottom of the
251
\item The member options page allows you to log in/out and change your
252
list settings, as well as unsubscribe or get a copy of your password
255
\item \textbf{To log in to your member options page}:
256
If you are not already logged in, there will be a box near the top for
257
you to enter your password. (If you do not know your password, see
258
Section~\ref{sec:getpassword} for more information on getting your
259
password.) Enter your password in the box and press the button.
261
\item Once you are logged in, you will be able to view and change
262
all your list settings.
265
\item [List Archives]
267
\item Usually found at \url{http://WEBSERVER/pipermail/LISTNAME} if the
268
list is publicly archived, and
269
\url{http://WEBSERVER/mailman/private/LISTNAME} if the list is privately
270
archives. (For example,
271
\url{http://lists.example.com/pipermail/mylist} or
272
\url{http://lists.example.com/mailman/private/mylist})
274
\item The list archive pages have copies of the posts sent to the
275
mailing list, usually grouped by month. In each monthly group, the
276
posts are usually indexed by author, date, thread, and subject.
278
\item \note{Pipermail is the name of the default archiver that
279
comes with Mailman. Other archive programs are available.}
281
\item If the archive is private, you will need to supply your
282
subscribed email address and your password to log in. (See
283
Section~\ref{sec:getpassword} for more information on getting
288
% ----------------------------------------------------------------------------
289
\subsection{The email interface\label{sec:email}}
290
Every mailing list has a set of email addresses to which messages can be
291
sent. There's always one address for posting messages to the list, one
292
address to which bounces are sent, and addresses for processing email
293
commands. For a fictional mailing list called
294
\email{mylist@example.com}, you'd find these addresses:
297
\item \email{mylist@example.com} -- this is the email address people should
298
use for new postings to the list.
300
\item \email{mylist-join@example.com} -- by sending a message to this address,
301
a new member can request subscription to the list. Both the
302
\mailheader{Subject} header and body of such a message are
303
ignored. Note that mylist-subscribe@example.com is an alias for
306
\item \email{mylist-leave@example.com} -- by sending a message to this address,
307
a member can request unsubscription from the list. As with the
308
-join address, the \mailheader{Subject} header and body of the
309
message is ignored. Note that mylist-unsubscribe@example.com is
310
an alias for the -leave address.
312
\item \email{mylist-owner@example.com} -- This address reaches the list owner
313
and list moderators directly. This is the address you use if
314
you need to contact the person or people in charge.
316
\item \email{mylist-request@example.com} -- This address reaches a mail robot
317
which processes email commands that can be used to set member
318
subscription options, as well as process other commands.
319
A list of members' email commands is provided in
320
Appendix~\ref{a:commands}.
322
\item \email{mylist-bounces@example.com} -- This address receives bounces from
323
members whose addresses have become either temporarily or
324
permanently inactive. The -bounces address is also a mail robot
325
that processes bounces and automatically disables or removes
326
members as configured in the bounce processing settings. Any
327
bounce messages that are either unrecognized, or do not seem to
328
contain member addresses, are forwarded to the list
331
\item \email{mylist-confirm@example.com} -- This address is another email
332
robot, which processes confirmation messages for subscription
333
and unsubscription requests.
336
There's also an -admin address which also reaches the list administrators,
337
but this address only exists for compatibility with older versions of
340
For changing options, we use the \email{LISTNAME-request}
341
address (for example, \email{mylist-request@example.com}).
343
Commands can appear in the subject line or the body of the message. Each
344
command should be on a separate line. If your mail program automatically
345
appends a signature to your messages, you may want to put the word
346
"\var{end}" (without the quotes) on a separate line after your other commands.
347
The \var{end} command tells Mailman not to process the email after that
350
The most important command is probably the "\var{help}" command, since it
351
makes Mailman return a message full of useful information about the
352
email commands and directions to the web interface.
354
Quick references to the subscriber commands have been provided in
355
Appendices \ref{a:commands} and \ref{a:options}. (These have been slightly
356
adapted from the output of the \var{help} command.)
359
% ============================================================================
360
\section{I need to talk to a human!\label{sec:human}}
362
If you have any trouble with any of these commands, you can always reach the
363
person or people in charge of a list by using the list administrator email address.
364
The list administrators can help you figure out
365
how to do something, subscribe/unsubscribe you, or change your
366
settings if you are unable to change them yourself for some reason. Please
367
remember that many mailing list administrators are volunteers who are donating
368
their spare time to run the list, and they may be very busy people.
370
This list administrator email address is in the form \email{LISTNAME-owner@DOMAIN}, where LISTNAME is the name of the list (eg: mailman-users) and DOMAIN is
371
the name of the server (eg: python.org).
373
along with the email addresses of specific administrators, is given on the
374
bottom of the list information pages. See Section~\ref{sec:web} for more
375
information on finding the list information page for your list
377
% ============================================================================
378
\section{Subscribing and unsubscribing}
379
Since subscribing (joining) and unsubscribing (leaving) lists are often the
380
only things a list member needs to know, these can both be done without
381
requiring you to know a password.
383
% ----------------------------------------------------------------------------
384
\subsection{How do I join a list? (subscribe)\label{sec:subscribe}}
386
There are two common ways you can subscribe to a Mailman mailing list.
388
Using the web interface:
390
\item Go to the list information page for the list you want to join.
391
(This will probably be something like
392
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
393
\item Look for the section marked "Subscribing to LISTNAME" and fill in the
394
boxes. You can fill in the following:
396
\item You \emph{must} enter your email address.
397
\item You may choose to supply your real name.
398
\item You may choose a password. If you do not choose one, Mailman will
399
generate one for you.
401
\warning{Do NOT use a valuable password, since this
402
password may be mailed to you in plain text. }
403
\item If the list supports more than one language, you may be able to
404
choose your preferred language. \note{This setting does not affect
405
posts to the list, only pre-prepared Mailman texts such as your member
408
\item Press the subscribe button. A new page should appear telling you
409
that your request has been sent.
412
Using the email interface:
414
\item Open a mail program which sends mail from the address you want to
416
\item Send a mail to the list subscription address, which will be in the
417
form \email{LISTNAME-join@DOMAIN}. The subject and body
418
of the message will be ignored, so it doesn't matter what you put there.
421
After following one of these sets of instructions (you don't need to do
422
both!), there are a few possible outcomes depending upon the settings for
425
\item You may receive an email message asking for confirmation that you
426
really want to be subscribed to the list. This is to prevent anyone from
427
subscribing you to lists without your permission. Follow the instructions
428
given in the message to confirm your wish to be subscribed.
429
\item A moderator may also need
430
to confirm your subscription if you are subscribing to a limited list.
432
you may have to wait for a moderator \textit{and} follow the instructions in
433
the confirmation mail.
436
Once this is done, you will likely receive another message welcoming you to
437
the list. This message contains some useful information including your list
438
password and some quick links for changing your options, so you may want to
439
save it for later reference.
441
\note{Subscribing can be done in other ways as well. See
442
Appendix~\ref{a:commands} for more advanced email subscribing commands.}
444
% ----------------------------------------------------------------------------
445
\subsection{How do I leave a list? (unsubscribe)\label{sec:unsubscribe}}
447
Don't want to be on a list any more? If you're just going on vacation or
448
are too busy to read mails and want to temporarily turn them off, you may want
449
to stop mail delivery rather than unsubscribing. This means you keep your
450
password and other settings so you can, for example, still have access to
451
private list archives. If this is what you'd
452
prefer, see Section~\ref{sec:nomail} for instructions on disabling mail
453
delivery temporarily.
455
If you actually want to leave the list, there are two common ways you can
456
unsubscribe from a Mailman mailing list.
458
Using the web interface:
460
\item Go to the list information page for the list you want to leave.
461
(This will probably be something like
462
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
463
\item Look for the section marked "LISTNAME subscribers" (usually found
464
near the bottom of the page).
465
\item There should be a button marked "Unsubscribe or Edit Options."
466
Enter your email address in the box beside this button and press the
468
\item You should be brought to a new page which has an "Unsubscribe"
469
button. Press it to unsubscribe and follow the instructions given.
472
Using the email interface:
474
\item Open a mail program which sends mail from the address you want to
476
\item Send a mail to the list unsubscribe address, which will be of the form
477
\email{LISTNAME-leave@DOMAIN}.
479
of this message will be ignored, so it doesn't matter what you put there.
482
After following one of these sets of instructions (you don't need to do
483
both!), you will be sent a confirmation mail and must follow the
484
instructions given in that mail to complete the unsubscription. This is to
485
stop people from unsubscribing you without your permission. In addition, a
486
moderator may need to approve your unsubscription.
488
If you do not receive this confirmation mail with instructions, make sure
489
that you typed your email address correctly (if you were using the web
490
interface to unsubscribe) and that the address you tried
491
to unsubscribe is, indeed, actually subscribed to that list. For security
492
reasons, Mailman generates the same member options page regardless of
493
whether the address entered is subscribed or not. This means that people
494
cannot use this part of the web interface to find out if someone is
495
subscribed to the list, but it also means that it's hard to tell if you just
498
Once your unsubscription has been processed, you will will probably receive
499
another message confirming your unsubscription from the list, and at that
500
point you should stop receiving messages.
502
If you wish to skip the confirmation process (for example, you might be
503
unsubscribing an address which no longer works), it is possible to bypass it by
504
using your password instead and either logging in to your options page using
505
it (See Section~\ref{sec:web}), or sending it with your email commands to
506
LISTNAME-request (See Appendix~\ref{a:commands} for advanced email
507
unsubscription commands). See Section~\ref{sec:getpassword} for more
508
information on getting your password.
510
% ============================================================================
511
\section{Passwords\label{sec:password}}
512
Your password was either set by you or generated by Mailman when you
514
You probably got a copy of it in a
515
welcome message sent when you joined the list, and you may also receive a
516
reminder of it every month. It is used to verify your identity to Mailman
517
so that only the holder of the password (you!) and the administrators
518
can view and change your settings.
520
\warning{Do NOT use a valuable password for Mailman, since it can be
521
sent in plain text to you.}
523
% ----------------------------------------------------------------------------
524
\subsection{How do I get my password?\label{sec:getpassword}}
525
If you've forgotten your password and haven't saved the welcome message or
526
any reminder messages, you can always get a reminder through the web interface:
529
\item Go to the list information page for the list from which you wish to
531
(This will probably be something like
532
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
533
\item Look for the section marked "LISTNAME subscribers"
534
(this section is usually found near the bottom of the page).
535
\item There should be a button marked "Unsubscribe or Edit Options."
536
Enter your email address in the box beside this button and press the
538
\item You should be brought to a new page which has an "Password
539
Reminder" section. Press the "Remind" button to have your password
543
If you do not receive the password reminder email after doing this, make sure
545
email address correctly and that the address you used is, indeed, actually
546
subscribed to that list. For security reasons, Mailman generates the same
547
member options page regardless of whether the address entered is subscribed
548
or not. This means that people cannot use this part of the web interface to
549
find out if someone is subscribed to the list, but it also means that it's
550
hard to tell if you just made a typo.
552
You can also get a reminder using the email interface,
554
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
558
in either the body or the subject of the message. (See
559
Section~\ref{sec:email} for more information about sending mail
562
If you are not sending mail from your subscribed address, you can also
563
specify this address by sending the command \nolinebreak{\var{password~address=$<$ADDRESS$>$}}.
566
% ----------------------------------------------------------------------------
567
\subsection{How do I change my password?}
568
\warning{Do NOT use a valuable password, since this
569
password may be mailed to you in plain text. }
571
From the web interface:
573
\item Log in to your member options page. (See Section~\ref{sec:web} for
574
instructions on how to do this.)
576
\item Look for the password changing boxes on the right-hand side of the
577
page and enter your new password in the appropriate boxes, then press the
578
button marked "Change My Password."
581
This can also be changed for multiple lists at the same time if you are subscribed to
582
more than one list on the same domain. See Section~\ref{sec:global} for
583
information about changing settings globally.
586
From the email interface:
588
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
589
\nolinebreak{\var{password~$<$OLDPASSWORD$>$~$<$NEWPASSWORD$>$}}.
592
in either the body or the subject of the message. (See
593
Section~\ref{sec:email} for more information about sending mail
596
If you are not sending mail from your membership address, you can also
597
specify this address with \var{address=$<$ADDRESS$>$} after $<$NEWPASSWORD$>$.
599
For example, if \email{kathy@here.com} wanted to change her \var{mylist}
600
password from \var{zirc} to \var{miko}, but she was sending mail from
601
her work address \email{kathy@work.com}, she could send a message
602
to \email{mylist-request@example.com} with the subject set to
603
\nolinebreak{\var{password~zirc~miko~address=kathy@here.com}}.
606
% ----------------------------------------------------------------------------
607
\subsection{How do I turn password reminders on or off? (reminders option)}
608
If you don't wish to the reminder email including your password every month,
609
you can disable it from the member options page. (You can always get the
610
password mailed out when you actually want it. See
611
Section~\ref{sec:getpassword} for instructions.)
613
Using the web interface:
615
\item Log in to your member options page. (See Section~\ref{sec:web} for
616
instructions on how to do this.)
617
\item Look for the section marked "Get password reminder email for this
618
list?" and change the value accordingly.
621
This can also be changed for multiple lists at the same time if you are subscribed to
622
more than one list on the same domain. See Section~\ref{sec:global} for
623
information about changing settings globally.
625
Using the email interface:
627
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
628
\var{set~reminders~on} or \var{set~reminders~off}.
631
in either the body or the subject of the message. (See
632
Section~\ref{sec:email} for more information about sending mail
634
\item Set it to "on" to receive reminders, and "off" to stop receiving
639
% ============================================================================
640
\section{Changing mail delivery}
641
% ----------------------------------------------------------------------------
642
\subsection{How do I turn mail delivery on or off?
643
(delivery option)\label{sec:nomail}}
645
You may wish to temporarily stop getting messages from the
646
list without having to unsubscribe.
647
If you disable mail delivery, you will no longer receive messages, but will
648
still be a subscriber and will retain your password and other settings.
650
This can be handy in a many different cases. For example, you could be
651
going on vacation or need a break from the list because you're too busy to
653
Many mailing lists also allow only subscribers to post to the list, so if you
654
commonly send mail from more than one address (eg, one address for at home
655
and another for when you're travelling), you may want to have more than
656
one subscribed account, but have only one of them actually receive mail.
657
You can also use this as a way to read private archives even on a list which
658
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
659
log in to the archives.
661
To disable/enable mail delivery using the web interface:
663
\item Log in to your options page. (See Section~\ref{sec:web} for instructions.)
664
\item Go down to the section marked "Mail delivery" and select "Disabled"
665
to stop receiving mail, and "Enabled" to start receiving mail.
668
This can also be changed for multiple lists at the same time if you are subscribed to
669
more than one list on the same domain. See Section~\ref{sec:global} for
670
information about changing settings globally.
672
To disable/enable mail delivery using the email interface:
674
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
675
\var{set~delivery~off} or \var{set~delivery~on}.
678
in either the body or the subject of the message. (See
679
Section~\ref{sec:email} for more information about sending mail
681
\item Set it to "off" to stop receiving posts, and "on" to start
682
receiving them again.
685
% ----------------------------------------------------------------------------
686
\subsection{How can I avoid getting duplicate messages? (duplicates option)
689
Mailman can't completely stop you from getting duplicate messages, but it
690
can help. One common reason people get multiple copies of a mail is that
691
the sender has used a "group reply" function to send mail to both the list and
692
some number of individuals. If you want to avoid getting these messages,
693
Mailman can be set to check and see if you are in the \mailheader{To} or
694
\mailheader{CC} lines of the message. If your address appears there,
695
then Mailman can be told not to deliver another copy to you.
697
To turn this on or off using the web interface:
699
\item Log in to your member options page. (See Section~\ref{sec:web}
700
for more details on how to do this.)
701
\item Scroll down to the bottom of the page to the section marked
702
"Avoid duplicate copies of messages?" and change the value accordingly.
705
This can also be changed for multiple lists at the same time if you are subscribed to
706
more than one list on the same domain. See Section~\ref{sec:global} for
707
information about changing settings globally.
709
To turn this on or off using the email interface:
711
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
712
\var{set~duplicates~on} or \var{set~duplicates~off}.
715
in either the body or the subject of the message. (See
716
Section~\ref{sec:email} for more information about sending mail
718
\item Set it to "on" to receive list copies of messages already sent
719
to you, set it to "off" to avoid receiving these duplicates.
723
% ----------------------------------------------------------------------------
724
\subsection{How do I change my subscription address?\label{sec:changeaddress}}
725
To change your subscription address,
727
\item Log in to your member options page. (See Section~\ref{sec:web}
728
for more details on how to do this.)
729
\item In the section marked "Changing your LISTNAME membership information,"
730
enter your new address.
731
\item If you wish to change your address for all subscriptions using the
732
old address, select the "Change globally" box. If you have subscriptions
733
under another address or for lists on a different domain, these will have
734
to be done separately. See Section~\ref{sec:global} for more
735
information about changing settings globally.
738
There is no special way to do this from the email interface, but you can
739
subscribe and unsubscribe for more or less the same effect. (See
740
Sections~\ref{sec:subscribe} and \ref{sec:unsubscribe} for more information
741
on subscribing and unsubscribing.)
743
% ----------------------------------------------------------------------------
744
\subsection{How do I stop or start getting copies of my own posts? (myposts
745
option)\label{sec:getown}}
746
By default in Mailman, you get a copy of every post you send to the list.
747
Some people like this since it lets them know when the post has gone through
748
and means they have a copy of their own words with the rest of a discussion,
749
but others don't want to bother downloading copies of their own posts.
751
\note{This option has no effect if you are receiving digests.}
753
You may also want to see Section~\ref{sec:getack}, which discusses
754
acknowledgement emails for posts sent to the list.
756
To set this using the web interface:
758
\item Log in to your member options page. (See Section~\ref{sec:web}
759
for more details on how to do this.)
760
\item Look for the section marked "Receive your own posts to the list?"
761
Set it to "Yes" to receive copies of your own posts, and "No" to avoid
765
To set this using the email interface:
767
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
768
\var{set~myposts~on} or \var{set~myposts~off}.
771
in either the body or the subject of the message. (See
772
Section~\ref{sec:email} for more information about sending mail
774
\item Set it to "on" to receive copies of your own posts, and "off"
775
to avoid receiving them.
779
% ----------------------------------------------------------------------------
780
\subsection{How can I get Mailman to tell me when my post has been received
781
by the list? (ack option)\label{sec:getack}}
783
On most lists, you will simply receive a copy of your mail when it has gone
784
through the list software, but if this is disabled (See
785
Section~\ref{sec:getown}), your list mail delivery is disabled (See
786
Section~\ref{sec:nomail}), you are not subscribed to that topic (See
787
Section~\ref{sec:sometopic}) or you
788
simply want an extra acknowledgement from the system, this option may
791
\note{If you are not subscribed to the list, this option cannot be used.
792
You must either check the archives yourself (if the list has public archives),
793
ask someone who is subscribed to the list, or subscribe to use this option.}
795
To set this using the web interface:
797
\item Log in to your member options page. (See Section~\ref{sec:web}
798
for more details on how to do this.)
799
\item Look for the section marked "Receive acknowledgement mail when you
800
send mail to the list?"
801
Set it to "Yes" to receive a mail letting you know your post has been
802
received, and "No" to avoid receiving such an acknowledgement.
805
To set this using the email interface:
807
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
808
\var{set~ack~on} or \var{set~ack~off}.
811
in either the body or the subject of the message. (See
812
Section~\ref{sec:email} for more information about sending mail
814
\item Set it to "on" if you wish to receive mail letting you know your
815
post has been received, and "off" to avoid receiving such an
819
% ----------------------------------------------------------------------------
820
\subsection{I don't seem to be getting mail from the lists. What should
822
There are a few common reasons for this:
824
\item No one has sent any mail to the list(s) you're on for a little while.
826
To check if this is the case, try visiting the archives of the list
827
(assuming that the list has archives). If the list has no archives, you
828
may have to ask another subscriber. (See Section~\ref{sec:web} for help
829
in finding the list archives.)
831
\note{Generally, it is considered
832
impolite to send test messages to the entire list.
833
If you feel a need to test that the list is working and for some reason you
834
cannot simply compose a regular message to the list, it is less disruptive
835
to send a help message to
836
the list request address (LISTNAME-request@DOMAIN) to see if that works,
837
or to contact the list
838
administrator (LISTNAME-owner@DOMAIN) to ask if the list is working.}
840
\item You were bouncing mail and have had mail delivery (temporarily)
841
disabled by the list software.
843
If your mail provider "bounces" too many messages (that is, it tells
844
Mailman that the message could not be delivered)
845
Mailman eventually stops trying to send you mail. This feature allows
846
Mailman to gracefully handle addresses which no longer exist (for example,
847
the subscriber has found a new internet service provider and forgot to
848
unsubscribe the old address), as well
849
as addresses which are temporarily out-of-service (for example, the
850
subscriber has used up all of the allotted space for his or her email
851
account, or the subscriber's mail provider is experiencing difficulties).
853
Even if you are unaware of any difficulties with your mail provider, it
854
is a good idea to check this. Some popular webmail providers and
855
internet servers are not as reliable as one might assume, nor is the
856
internet as a whole. You may want to also send yourself a test message
857
from another account or ask a friend to send you a test message to make
858
sure your subscribed address is working.
860
To check if this may be the reason you are not receiving messages, log in
861
to the your options page (See
862
Section~\ref{sec:web} for more details on how to do this) and
863
look at your options. There should be one marked "Mail Delivery" --
864
if it is set to "Disabled," set it to "Enabled" to start receiving mail
865
again. (For more instructions on disabling or enabling mail delivery,
866
see Section~\ref{sec:nomail}.)
868
\note{Even if you have not been disabled at the time you check, you could be
869
bouncing messages and not have reached the threshold for your
870
subscription to be disabled. You may need to check again.}
872
\item There is a delay or break in the networks between you and the
875
No matter what many of us would like, the internet is not 100\%
876
reliable, nor is it always fast. Sometimes, messages simply take a long
877
time to get to you. Try to be patient, especially if the server is far
878
(in terms of networks, not geography, although often one implies the other)
879
from your internet service provider.
881
To check if this might be causing your problem, you can try pinging
882
the list server or tracing the route between you and it. (Instructions
883
on how to do this varies from platform to platform, so you may want to
884
use a search engine to find those appropriate for you.)
886
\item The Mailman installation on the list server is not functioning or
887
not functioning properly.
889
To test if this is a case, try visiting the list's web interface and
890
try sending a message to \email{LISTNAME-request@DOMAIN} with the command
891
"\var{help}" (without the quotes) in the \mailheader{Subject}. If
892
neither of these works after a reasonable length of time, this may be
893
the problem. You may wish to contact either the list or site
898
% ============================================================================
900
% ----------------------------------------------------------------------------
901
\subsection{How can I start or stop getting the list posts grouped into one
902
big email? (digest option)\label{sec:digest}}
904
Groups of posts are called "digests" in Mailman. Rather than get messages
905
one at a time, you can get messages grouped together. On a moderately busy
906
list, this typically means you get one email per day, although it may be
907
more or less frequent depending upon the list.
909
You may also want to look at Section~\ref{sec:MIME} which discusses MIME
910
and plain text digests.
912
To turn digest mode on or off using the web interface,
914
\item Log in to your member options page. (See Section~\ref{sec:web}
915
for more details on how to do this.)
916
\item Look for the section marked "Set Digest Mode."
919
receive messages bundled together in digests. Set it to "Off" to
920
receive posts separately.
923
To turn digest mode on or off using the email interface,
925
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
926
\var{set~digest~plain} or \var{set~digest~mime} or \var{set~digest~off}.
929
in either the body or the subject of the message. (See
930
Section~\ref{sec:email} for more information about sending mail
932
\item Set it to "off" if you wish to receive individual posts separately,
933
and to "plain" or "mime" to receive posts grouped into one large mail.
934
See Section~\ref{sec:MIME} for more information on plain versus MIME
939
% ----------------------------------------------------------------------------
940
\subsection{What are MIME and Plain Text Digests? How do I change which one
941
I get? (digest option)\label{sec:MIME}}
943
MIME is short for Multipurpose Internet Mail Extensions. It is used to
944
send things by email which are not necessarily simple plain text. (For
945
example, MIME would be used if you were sending a picture of your dog to
948
A MIME digest has each message as an attachment inside the message, along
949
with a summary table of contents.
951
A plain text digest is a simpler form of digest, which should be readable
952
even in mail readers which don't support MIME. The messages are simply put
953
one after the other into one large text message.
955
Most modern mail programs do support MIME, so you only need to choose
956
plain text digests if you are having trouble reading the MIME ones.
958
\note{This option has no effect if you are not receiving mail bunched
959
as digests. (See Section~\ref{sec:digest} for more information on
960
receiving mail as digests.)}
962
To set your digest type using the web interface:
964
\item Log in to your member options page. (See Section~\ref{sec:web}
965
for more details on how to do this.)
966
\item Look for the section marked "Get MIME or Plain Text Digests?."
968
Set it to "MIME" to receive digests in MIME format, or "Plain text" to
969
receive digests in plain text format.
972
This can also be changed for multiple lists at the same time if you are subscribed to
973
more than one list on the same domain. See Section~\ref{sec:global} for
974
information about changing settings globally.
976
To set your digest type using the email interface,
978
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
979
\var{set~digest~plain} or \var{set~digest~mime}.
982
in either the body or the subject of the message. (See
983
Section~\ref{sec:email} for more information about sending mail
985
\item Set it to "plain" to get posts bundled into a plain text digest,
986
or "mime" to get posts bundled together into a MIME digest.
989
% ----------------------------------------------------------------------------
990
\section{Mailing list topics\label{sec:topics}}
992
Some lists are set up so that different topics are handled by Mailman.
993
For example, the courses list on Linuxchix.org is a discussion list for
994
courses being run by linuxchix members, and often there are several courses
995
being run at the same time.
996
(eg: Networking for beginners, C programming, \LaTeX ~document mark up.)
997
Each of the courses being run is a separate topic on the list so that people
998
can choose only to receive the course they want to take.
1001
topics must be configured by the list administrator, but it is the
1002
responsibility of each poster to make sure that their post is put with
1003
the correct topic. Usually, this means adding a tag of some type to the
1004
subject line (eg: [Networking] What type of cables do I need?) or making
1005
sure the \mailheader{Keywords} line has the right information. (By default,
1006
you can put a \mailheader{Keywords} section in the beginning of the body
1007
of your message, but this can be configured by your list administrator.)
1008
Note that these tags are case-insensitive.
1010
% ----------------------------------------------------------------------------
1011
\subsection{How do I make sure that my post has the right
1012
topic?\label{sec:posttopic}}
1014
When a list administrator defines a topic, he or she sets three things:
1017
\item a regular expression (regexp)
1021
You can view this information by logging in to your member options page.
1022
(See Section~\ref{sec:web} for more details on how to do this.) and
1023
clicking on the "details" link for any topic that interests you.
1025
To post on a given topic, you need to make sure that the
1026
\mailheader{Keywords} or \mailheader{Subject} headers in a message
1027
match the \emph{regular expression} for that topic.
1028
Regular expressions can actually be fairly complex, so you may want to
1029
just ask the list administrator if you don't know how to make
1030
heads or tails of the expression given.
1032
Most Mailman topic expressions will be fairly simple regular expressions, so
1033
in this document we will simply give you some common examples. Regular
1034
expressions are a bit too complex to teach in a few lines here, so if you
1035
really want to understand how the regular expressions work, you should
1036
find a tutorial or reference elsewhere. (For example, DevShed has a decent
1038
\url{http://www.devshed.com/Server_Side/Administration/RegExp/})
1040
Here are some examples of possible regular expressions and matching lines:
1042
\begin{tableii}{l|l}{}{Regular expression}{Matching lines}
1043
\lineii{zuff}{Keywords: zuff}
1044
\lineii{zuff}{Keywords: ZUFF}
1045
\lineii{zuff}{Keywords: Zuff}
1046
\lineii{zuff}{Keywords: amaryllis, zuff, applesauce}
1047
\lineii{zuff}{Subject: [zuff] Do you have the right stuff for zuff?}
1048
\lineii{zuff}{Subject: Do you have the right stuff for zuff?}
1049
\lineii{zuff}{Subject: What is zuff?}
1051
\lineii{\textbackslash[zuff\textbackslash]}{Keywords: [zuff]}
1052
\lineii{\textbackslash[zuff\textbackslash]}{Subject: [zuff] Do you have the right stuff?}
1053
\lineii{\textbackslash[zuff\textbackslash]}{Subject: Online zuff tutorials (was Re: [zuff] What is zuff?)}
1058
\item The matching is case-insensitive, so if zuff matches, so will ZUFF,
1059
zuFF, and any other variations in capitalization.
1060
\item Some characters have special meaning in a regular expression, so
1061
to match those characters specifically, they must be "escaped" with a
1062
backslash (\textbackslash). As you can see in the above example,
1063
[ and ] are such characters. (Others include ".", "?", and "*").
1064
The backslash is also used for other things (I wasn't kidding about
1065
regular expressions being complex: consult other documentation
1066
for details about other uses of the backslash character), but this
1067
is the most likely use in a topic expression.
1070
% ----------------------------------------------------------------------------
1071
\subsection{How do I subscribe to all or only some topics on a
1072
list?\label{sec:sometopic}}
1074
If topics have been set up by your mailing list administrator, you can
1075
choose to subscribe to only part of a list by selecting the topics you
1078
If you wish to get all messages sent to the list, make sure you
1079
are not subscribed to any topics.
1082
\item Log in to your member options page. (See Section~\ref{sec:web}
1083
for more details on how to do this.)
1084
\item Look for the section marked "Which topic categories would you like
1087
If any topics are defined, you can select those you wish. If you do
1088
not select any topics of interest, you will receive all posts
1092
You probably also want to look at Section~\ref{sec:notopic} which discusses
1093
changing your settings for messages where no topic is set.
1095
% ----------------------------------------------------------------------------
1096
\subsection{How do I get or avoid getting messages with no topic set?
1097
\label{sec:notopic}}
1098
If you wish to get all messages sent to the list, make sure you are
1099
not subscribed to any specific topic. (See Section~\ref{sec:sometopic}.)
1101
If you are only subscribed to some topics, you can either choose to either
1102
receive or not receive messages with no topic set, much the way you can
1103
choose to subscribe only to certain topics.
1105
To change this setting,
1107
\item Log in to your member options page. (See Section~\ref{sec:web}
1108
for more details on how to do this.)
1109
\item Look for the section marked "Do you want to receive message that do
1110
not match any topic filter?"
1112
If you wish to receive messages with no topic set, select "Yes." If you
1113
do not wish to receive such messages, choose "No."
1116
This setting has no effect if you are not subscribed to any topics.
1118
% ============================================================================
1119
\section{Setting other options}
1121
% ----------------------------------------------------------------------------
1122
\subsection{Change Globally? Set Globally? What does that mean?
1125
For some of the options given in your member options page, there is a
1126
tick-box which says "Change Globally" or "Set Globally."
1127
This means that if you change this
1128
option, you can also have the change made for all your other list
1129
subscriptions with the same address to lists on the same domain.
1130
This can be handy if, for example, you
1131
want to make sure all your passwords are the same, or you are going on
1132
vacation and want to turn off mail delivery from all the lists.
1134
% ----------------------------------------------------------------------------
1135
\subsection{How do I change my name as Mailman knows it?
1136
\label{sec:changename}}
1138
To change your subscription name,
1140
\item Log in to your member options page. (See Section~\ref{sec:web}
1141
for more details on how to do this.)
1142
\item In the section marked "Changing your LISTNAME membership information,"
1143
enter your new name in the appropriate box.
1146
This can also be changed for multiple lists at the same time if you are subscribed to
1147
more than one list on the same domain. See Section~\ref{sec:global} for
1148
information about changing settings globally.
1150
\note{You do not need to have a subscription name set.}
1152
% ----------------------------------------------------------------------------
1153
\subsection{How do I set my preferred language?}
1155
Mailman is available with many different languages.
1156
(For a complete listing see \url{http://mailman.sourceforge.net/i18n.html}.) This means that, if your list has
1157
other languages enabled, you may be able to have the web interface, etc. in a
1158
language of your choice.
1160
\note{This does NOT necessarily mean that all the posts sent to the list will
1161
be in the language you selected. Only the pre-prepared texts presented by
1162
Mailman will be affected by this setting. Posts are in whatever language the
1165
Your preferred language is set when you subscribe (see
1166
Section\ref{sec:subscribe}), and can be changed later if the list supports
1167
more than one language.
1169
To change your preferred language in Mailman,
1171
\item Log in to your member options page. (See Section~\ref{sec:web} for
1172
instructions on how to do this.)
1173
\item Go to the section marked "What language do you prefer?" and choose
1174
the appropriate language from the drop-down list. If there is no
1175
drop-down list of languages, the list you are on probably only supports
1179
If your list does not support the language you would prefer to use, you may
1180
contact the list administrator (LISTNAME-owner@DOMAIN) to see if it can be
1181
added, but remember that this may mean some work that the list and/or site
1182
administrator(s) do not have time or the ability to do.
1184
If your language of choice is not available because no translation
1185
exists for Mailman, please consider volunteering your time as a translator.
1186
For more information you may want to consult the mailman-i18n mailing
1187
list at \url{http://mail.python.org/mailman/listinfo/mailman-i18n}.
1188
(i18n is a common short-hand for "internationalization" because the word starts
1189
with an i, ends with an n, and has 18 letters in between. If you mumble a bit,
1190
i18n even sounds a bit like "internationalization.")
1192
% ----------------------------------------------------------------------------
1193
\subsection{How do I avoid having my name appear on the subscribers list?
1194
(the hide option)\label{sec:nolist}}
1196
If you do not want to have your email address show up on the subscriber list
1197
for any reason, you can opt to have it concealed.
1199
Common reasons for doing this include avoiding unsolicited bulk email (spam).
1200
By default, the subscribers list is obscured to hinder spam harvesters,
1201
but if you feel this is insufficient it's easy enough to remove address
1202
from the subscriber list given in the information pages or by email request.
1203
(Note that this does not conceal your address from the list administrators.)
1204
You may wish to see Section~\ref{sec:antispam} for more information on what
1205
Mailman can do to help avoid spam.
1207
To change this setting using the web interface:
1209
\item Log in to your member options page. (See Section~\ref{sec:web} for
1210
instructions on how to do this.)
1211
\item Go to the section marked "Conceal yourself from subscriber list?" and
1212
choose "Yes" to hide your name from the list, or "No" to allow your name
1213
to appear on the list.
1216
To change this setting using the email interface:
1218
\item Send a mail to \email{LISTNAME-request@DOMAIN} with the command
1219
\var{set~hide~on} or \var{set~hide~off}.
1222
in either the body or the subject of the message. (See
1223
Section~\ref{sec:email} for more information about sending mail
1225
\item Set it to "on" to conceal your email address from the membership
1226
list, or "off" to stop concealing your address.
1229
% ============================================================================
1230
\section{Other common questions}
1232
% ----------------------------------------------------------------------------
1233
\subsection{How do I view the list archives?}
1234
If the list has archives, they can be viewed by going to a web page address.
1235
This address usually linked from the list information page and can be found in
1236
the \mailheader{List-Archive} of every list message unless your list
1237
administrator has disabled these headers. (Many mail programs hide the
1238
\mailheader{List-Archive} mail header, so you may have to tell your
1239
mail program to allow you to view full headers before you will be able to
1242
Public archives usually have addresses of the form
1243
\url{http://WEBSERVER/pipermail/LISTNAME/} and private archives usually
1244
have addresses of the form \url{http://WEBSERVER/mailman/private/LISTNAME}.
1246
See Section~\ref{sec:web} for more information on finding the addresses of a
1249
% ----------------------------------------------------------------------------
1250
\subsection{What does Mailman do to help protect me from unsolicited bulk email
1251
(spam)?\label{sec:antispam}}
1253
A technical list's archives may include answers to a range of
1254
different questions. Often, the people who have posted these answers would
1255
be happy to help someone who doesn't quite understand the answer, and don't
1256
mind giving their address out for that purpose. But
1257
although it would be wonderful if everyone could contact each other easily,
1258
we also want to make sure that the list and list archives are not abused by
1259
people who send spam.
1261
To make a range of options available to list administrators, Mailman allows
1262
a variety of configurations to help protect email addresses.
1263
Many of these settings are optional to the list administrator, so your
1264
particular list may be set up in many ways. List administrators
1265
must walk a fine line between protecting subscribers and making it difficult
1266
for people to get in touch.
1269
\item Subscriber lists
1271
\item The list administrator can choose to have the subscriber list
1272
public, viewable only to list members, or viewable only to list
1274
\item The subscriber list is shown with the addresses obscured to
1275
make it difficult for spam harvesters to collect your address.
1276
\item You can choose to have your address hidden from the subscriber
1277
list. (See Section~\ref{sec:nolist} for more information.)
1278
\item \note{The entire subscriber list is always available to the
1279
list administrators.}
1284
\item The list administrator can choose for the archives to be public,
1285
viewable only to members (private), or completely unavailable.
1286
\item The HTML archives which are created by Pipermail (the
1287
archiving program which comes default with Mailman) contain only
1288
obscured addresses. Other archiving programs are available and can
1289
do different levels of obfuscation to make addresses less readable.
1290
\item If you wish to be more sure, you can set the mail header
1291
\mailheader{X-no-archive} and Mailman will not archive your posts.
1292
\warning{This does not stop other members from quoting your posts,
1293
possibly even including your email address.}
1296
\item Limited posting to the lists
1298
\item The list administrator can choose who can post to the list.
1299
Most lists are either moderated (a moderator or administrator
1300
reviews each posting), set so only subscribers may post to the list,
1301
or allow anyone to post to the list.
1302
\item By allowing only subscribers to post to a list, Mailman often
1303
blocks all spam and some viruses from being sent through the list.
1304
As such, this is a fairly common setting used by list administrators.
1307
\item Anonymous lists
1309
\item Lists can also be made fully anonymous: all identifying
1310
information about the sender is stripped from the header before the
1312
\item This is not typically used for anti-spam measures (it has
1313
other uses), but it could be used in that way if desired.
1317
Of course, many address-obscuring methods can be circumvented by determined
1318
people, so be aware that the protections used may not be enough.
1320
% ============================================================================
1322
% ----------------------------------------------------------------------------
1323
\section{Email commands quick reference\label{a:commands}}
1325
\item confirm $<$CONFIRMATION-STRING$>$
1328
Confirm an action. The confirmation-string is required and should be
1329
supplied within a mailback confirmation notice.
1335
Stop processing commands. Use this if your mail program automatically
1336
adds a signature file.
1342
Receive a copy of the help message.
1348
Get information about this mailing list.
1354
See a list of the public mailing lists on this GNU Mailman server.
1357
\item {password [$<$OLDPASSWORD$>$ $<$NEWPASSWORD$>$] [address=$<$ADDRESS$>$]}
1360
Retrieve or change your password. With no arguments, this returns
1361
your current password. With arguments $<$OLDPASSWORD$>$ and $<$NEWPASSWORD$>$
1362
you can change your password.
1368
Set or view your membership options.
1370
Use `set help' (without the quotes) to get a more detailed list of the
1371
options you can change. This list is also given in
1372
Appendix~\ref{a:options}.
1374
Use `set show' (without the quotes) to view your current option
1378
\item{subscribe [$<$PASSWORD$>$] [digest|nodigest] [address=$<$ADDRESS$>$]}
1381
Subscribe to this mailing list. Your password must be given to
1382
unsubscribe or change your options, but if you omit the password, one
1383
will be generated for you. You may be periodically reminded of your
1386
The next argument may be either: `nodigest' or `digest' (no quotes!).
1387
If you wish to subscribe an address other than the address you sent
1388
this request from, you may specify `address=$<$ADDRESS$>$' (no brackets
1389
around the email address, and no quotes!)
1392
\item {unsubscribe [$<$PASSWORD$>$] [address=$<$ADDRESS$>$]}
1395
Unsubscribe from the mailing list. If given, your password must match
1396
your current password. If omitted, a confirmation email will be sent
1397
to the unsubscribing address. If you wish to unsubscribe an address
1398
other than the address you sent this request from, you may specify
1399
`address=$<$ADDRESS$>$' (no brackets around the email address, and no
1403
\item {who [$<$PASSWORD$>$] [address=$<$ADDRESS$>$]}
1406
See everyone who is on this mailing list. The roster is limited to
1407
list members only, and you must supply your membership password to
1408
retrieve it. If you're posting from an address other than your
1409
membership address, specify your membership address with
1410
`address=$<$ADDRESS$>$' (no brackets around the email address, and no
1415
% ----------------------------------------------------------------------------
1416
\section{Member options quick reference\label{a:options}}
1421
\item Show this detailed help.
1424
\item {set show [address=$<$ADDRESS$>$]}
1426
\item View your current option settings. If you're posting from an address
1427
other than your membership address, specify your membership address
1428
with `address=$<$ADDRESS$>$' (no brackets around the email address, and no
1432
\item {set authenticate $<$PASSWORD$>$ [address=$<$ADDRESS$>$]}
1434
\item To set any of your options, you must include this command first, along
1435
with your membership password. If you're posting from an address
1436
other than your membership address, specify your membership address
1437
with `address=$<$ADDRESS$>$' (no brackets around the email address,
1445
When the `ack' option is turned on, you will receive an
1446
acknowledgement message whenever you post a message to the list.
1449
\item set digest plain\\
1454
When the `digest' option is turned off, you will receive postings
1455
immediately when they are posted. Use `set digest plain' if instead
1456
you want to receive postings bundled into a plain text digest
1457
(i.e. RFC 1153 digest). Use `set digest mime' if instead you want to
1458
receive postings bundled together into a MIME digest.
1461
\item set delivery on\\
1465
Turn delivery on or off. This does not unsubscribe you, but instead
1466
tells Mailman not to deliver messages to you for now. This is useful
1467
if you're going on vacation. Be sure to use `set delivery on' when
1468
you return from vacation!
1471
\item set myposts on\\
1475
Use `set myposts off' to avoid receiving copies of messages you post to
1476
the list. This has no effect if you're receiving digests.
1483
Use `set hide on' to conceal your email address when people request
1484
the membership list.
1487
\item set duplicates on\\
1491
Use `set duplicates off' if you want Mailman not to send you messages
1492
if your address is explicitly mentioned in the To: or Cc: fields of
1493
the message. This can reduce the number of duplicate postings you
1497
\item set reminders on\\
1500
\item Use `set reminders off' if you want to disable the monthly password
1501
reminder for this mailing list.
added
removed
doc/mailman-member.tex
