Update of /cvsroot/mailman/mailman/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv22645
Modified Files:
mailman-member.tex
Log Message:
Bugfixes/small edits stemming mostly from Barry's comments
Some more major revisions will be coming through shortly, mostly new sections
(page oriented description, additional explanation of email commands, etc.).
Index: mailman-member.tex
===================================================================
RCS file: /cvsroot/mailman/mailman/doc/mailman-member.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- mailman-member.tex 5 May 2003 05:57:03 -0000 1.1
+++ mailman-member.tex 1 Oct 2003 05:39:47 -0000 1.2
@@ -82,8 +82,8 @@
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
+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.}
@@ -103,7 +103,10 @@
work with an artificial life spam detector, and is actually more of a
programmer than technical writer.
-Proofreading thanks go to Margaret McCarthy and Jason Walton.
+Thanks to Margaret McCarthy, Jason Walton and Barry Warsaw for their help
+in proofreading and otherwise improving this manual.
+
+Thanks also to Ikeda Soji, who has made a Japanese translation of this document.
%WRITEME: More here. Do we need a license statement here?
@@ -119,33 +122,35 @@
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
+Announcement lists 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 concerts.
+list is used to send out magazines. For example, a band may use an
+announcement 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 amongst
+A discussion list allows a group of people to discuss topics amongst
themselves, with everyone able to send mail to the list and 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.
+might use a discussion mailing list to share tips about model construction and
+flying.
Some common terms:
\begin{itemize}
- \item A "post" typically denotes a message sent to a mailing list.
+ \item A ``post'' typically denotes a message sent to a mailing list.
(Think of posting a message on a bulletin board.)
\item People who are part of an electronic mailing list are usually called
- the list's "members" or "subscribers."
- \item "List administrators" are the people in charge of maintaining that
+ the list's ``members'' or ``subscribers.''
+ \item ``List administrators'' are the people in charge of maintaining that
one list. Lists may have one or more administrators.
\item 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.
\item 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
+ the lists is called the ``site administrator.'' Often the site administrator
also administrates individual lists.
\end{itemize}
% ----------------------------------------------------------------------------
@@ -214,7 +219,7 @@
% ----------------------------------------------------------------------------
\subsection{The web interface\label{sec:web}}
-The web interface of Mailman is its selling point for many administrators,
+The web interface of Mailman is its selling point for many people,
since it makes it much easier for subscribers and administrators to see
which options are available, and what these options do.
@@ -245,7 +250,7 @@
\item 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
+ marked ``Unsubscribe or Edit Options'' (this is near the
bottom of the
page).
\item The member options page allows you to log in/out and
change your
@@ -267,7 +272,7 @@
\item Usually found at
\url{http://WEBSERVER/pipermail/LISTNAME} if the
list is publicly archived, and
\url{http://WEBSERVER/mailman/private/LISTNAME} if the list is
privately
- archives. (For example,
+ archived. (For example,
\url{http://lists.example.com/pipermail/mylist} or
\url{http://lists.example.com/mailman/private/mylist})
@@ -319,17 +324,11 @@
A list of members' email commands is provided in
Appendix~\ref{a:commands}.
-\item [EMAIL PROTECTED] -- This address receives bounces from
- 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.
+\item [EMAIL PROTECTED] -- This address is used in
+ Mailman's automatic bounce processing.
-\item [EMAIL PROTECTED] -- This address is another email
- robot, which processes confirmation messages for subscription
+\item [EMAIL PROTECTED] -- This address is used for
+ processing confirmation messages for subscription
and unsubscription requests.
\end{itemize}
@@ -343,11 +342,11 @@
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
-"\var{end}" (without the quotes) on a separate line after your other commands.
+``\var{end}'' (without the quotes) on a separate line after your other commands.
The \var{end} command tells Mailman not to process the email after that
point.
-The most important command is probably the "\var{help}" command, since it
+The most important command is probably the ``\var{help}'' command, since it
makes Mailman return a message full of useful information about the
email commands and directions to the web interface.
@@ -390,7 +389,7 @@
\item Go to the list information page for the list you want to join.
(This will probably be something like
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
- \item Look for the section marked "Subscribing to LISTNAME" and fill in the
+ \item Look for the section marked ``Subscribing to LISTNAME'' and fill in the
boxes. You can fill in the following:
\begin{itemize}
\item You \emph{must} enter your email address.
@@ -399,14 +398,17 @@
generate one for you.
\warning{Do NOT use a valuable password, since this
- password may be mailed to you in plain text. }
+ password may occasionally be mailed to you in plain text. }
\item 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
+ posts to the list, only Mailman texts that come from the list software,
+ such as your member
options page.}
\end{itemize}
\item Press the subscribe button. A new page should appear telling you
- that your request has been sent.
+ that your subscription request has been received. This page will provide
+ you with further instructions, such as the need to wait for and reply to a
+ confirmation messages, depending on the list's subscription policies.
\end{enumerate}
Using the email interface:
@@ -427,7 +429,7 @@
subscribing you to lists without your permission. Follow the instructions
given in the message to confirm your wish to be subscribed.
\item A moderator may also need
-to confirm your subscription if you are subscribing to a limited list.
+to confirm your subscription if you are subscribing to a closed list.
\item Or
you may have to wait for a moderator \textit{and} follow the instructions in
the confirmation mail.
@@ -460,12 +462,12 @@
\item Go to the list information page for the list you want to leave.
(This will probably be something like
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
- \item Look for the section marked "LISTNAME subscribers" (usually found
+ \item Look for the section marked ``LISTNAME subscribers'' (usually found
near the bottom of the page).
- \item There should be a button marked "Unsubscribe or Edit Options."
+ \item There should be a button marked ``Unsubscribe or Edit Options.''
Enter your email address in the box beside this button and press the
button.
- \item You should be brought to a new page which has an "Unsubscribe"
+ \item You should be brought to a new page which has an ``Unsubscribe''
button. Press it to unsubscribe and follow the instructions given.
\end{enumerate}
@@ -483,7 +485,8 @@
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.
+moderator may need to approve your unsubscription. (Administrator-approved
+unsubscriptions are uncommon.)
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
@@ -530,13 +533,13 @@
get your password
(This will probably be something like
\url{http://WEBSERVER/mailman/listinfo/LISTNAME})
- \item Look for the section marked "LISTNAME subscribers"
+ \item Look for the section marked ``LISTNAME subscribers''
(this section is usually found near the bottom of the page).
- \item There should be a button marked "Unsubscribe or Edit Options."
+ \item There should be a button marked ``Unsubscribe or Edit Options.''
Enter your email address in the box beside this button and press the
button.
- \item You should be brought to a new page which has an "Password
- Reminder" section. Press the "Remind" button to have your password
+ \item You should be brought to a new page which has an ``Password
+ Reminder'' section. Press the ``Remind'' button to have your password
emailed to you.
\end{enumerate}
@@ -575,7 +578,7 @@
\item Look for the password changing boxes on the right-hand side of the
page and enter your new password in the appropriate boxes, then press the
- button marked "Change My Password."
+ button marked ``Change My Password.''
\end{enumerate}
This can also be changed for multiple lists at the same time if you are subscribed to
@@ -614,8 +617,8 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web} for
instructions on how to do this.)
- \item Look for the section marked "Get password reminder email for this
- list?" and change the value accordingly.
+ \item Look for the section marked ``Get password reminder email for this
+ list?'' and change the value accordingly.
\end{enumerate}
This can also be changed for multiple lists at the same time if you are subscribed to
@@ -631,7 +634,7 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "on" to receive reminders, and "off" to stop receiving
+ \item Set it to ``on'' to receive reminders, and ``off'' to stop receiving
reminders.
\end{enumerate}
@@ -661,8 +664,8 @@
To disable/enable mail delivery using the web interface:
\begin{enumerate}
\item Log in to your options page. (See Section~\ref{sec:web} for
instructions.)
- \item Go down to the section marked "Mail delivery" and select "Disabled"
- to stop receiving mail, and "Enabled" to start receiving mail.
+ \item Go down to the section marked ``Mail delivery'' and select ``Disabled''
+ to stop receiving mail, and ``Enabled'' to start receiving mail.
\end{enumerate}
This can also be changed for multiple lists at the same time if you are subscribed to
@@ -678,7 +681,7 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "off" to stop receiving posts, and "on" to start
+ \item Set it to ``off'' to stop receiving posts, and ``on'' to start
receiving them again.
\end{enumerate}
@@ -688,18 +691,20 @@
Mailman can't completely stop you from getting duplicate messages, but it
can help. One common reason people get multiple copies of a mail is that
-the sender has used a "group reply" function to send mail to both the list and
-some number of individuals. If you want to avoid getting these messages,
+the sender has used a ``group reply'' function to send mail to both the list
+and some number of individuals. If you want to avoid getting these messages,
Mailman can be set to check and see if you are in the \mailheader{To} or
-\mailheader{CC} lines of the message. If your address appears there,
-then Mailman can be told not to deliver another copy to you.
+\mailheader{CC} lines of the message. If your address appears there, then
+Mailman can be told not to deliver another copy to you. This means you get
+only the copy sent by the original sender, and not a copy which been altered by
+Mailman (to include headers and footers, strip attachments, etc.).
To turn this on or off using the web interface:
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
\item Scroll down to the bottom of the page to the section marked
- "Avoid duplicate copies of messages?" and change the value accordingly.
+ ``Avoid duplicate copies of messages?'' and change the value accordingly.
\end{enumerate}
This can also be changed for multiple lists at the same time if you are subscribed to
@@ -715,8 +720,8 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "on" to receive list copies of messages already sent
- to you, set it to "off" to avoid receiving these duplicates.
+ \item Set it to ``on'' to receive list copies of messages already sent
+ to you, set it to ``off'' to avoid receiving these duplicates.
\end{enumerate}
@@ -726,15 +731,19 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item In the section marked "Changing your LISTNAME membership information,"
+ \item In the section marked ``Changing your LISTNAME membership information,''
enter your new address.
\item If you wish to change your address for all subscriptions using the
- old address, select the "Change globally" box. If you have subscriptions
+ 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~\ref{sec:global} for more
information about changing settings globally.
\end{enumerate}
+A confirmation message will be sent to your new address, and the change will
+not happen until you confirm the change by following the instructions in that
+message.
+
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
Sections~\ref{sec:subscribe} and \ref{sec:unsubscribe} for more information
@@ -757,8 +766,8 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Receive your own posts to the list?"
- Set it to "Yes" to receive copies of your own posts, and "No" to avoid
+ \item Look for the section marked ``Receive your own posts to the list?''
+ Set it to ``Yes'' to receive copies of your own posts, and ``No'' to avoid
receiving them.
\end{enumerate}
@@ -771,7 +780,7 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "on" to receive copies of your own posts, and "off"
+ \item Set it to ``on'' to receive copies of your own posts, and ``off''
to avoid receiving them.
\end{enumerate}
@@ -796,10 +805,10 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Receive acknowledgement mail when you
- send mail to the list?"
- Set it to "Yes" to receive a mail letting you know your post has been
- received, and "No" to avoid receiving such an acknowledgement.
+ \item Look for the section marked ``Receive acknowledgement mail when you
+ send mail to the list?''
+ Set it to ``Yes'' to receive a mail letting you know your post has been
+ received, and ``No'' to avoid receiving such an acknowledgement.
\end{enumerate}
To set this using the email interface:
@@ -811,8 +820,8 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "on" if you wish to receive mail letting you know your
- post has been received, and "off" to avoid receiving such an
+ \item Set it to ``on'' if you wish to receive mail letting you know your
+ post has been received, and ``off'' to avoid receiving such an
acknowledgement.
\end{enumerate}
@@ -840,11 +849,11 @@
\item You were bouncing mail and have had mail delivery (temporarily)
disabled by the list software.
- If your mail provider "bounces" too many messages (that is, it tells
+ If your mail provider ``bounces'' too many messages (that is, it tells
Mailman that the message could not be delivered)
Mailman eventually stops trying to send you mail. This feature allows
Mailman to gracefully handle addresses which no longer exist (for example,
- the subscriber has found a new internet service provider and forgot to
+ 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
@@ -860,10 +869,17 @@
To check if this may be the reason you are not receiving messages, log in
to the your options page (See
Section~\ref{sec:web} for more details on how to do this) and
- look at your options. There should be one 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~\ref{sec:nomail}.)
+ look at your options.
+ If your subscription has been disabled or Mailman has received bounces from
+ your email address, there will be a big banner at the top of this page.
+
+ To re-enable mail delivery, look for an option marked ``Mail Delivery'' and
+ set it to ``Enabled'' to start receiving mail again.
+ To get rid of your bounce score, you can disable and then re-enable delivery.
+ For more instructions on disabling or enabling mail delivery,
+ see Section~\ref{sec:nomail}.
+
+
\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
@@ -883,12 +899,13 @@
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.)
- \item The Mailman installation on the list server is not functioning or
- not functioning properly.
+ \item The mail server or Mailman might not be functioning properly. This
+ can happen if the system is overloaded with viruses or spam and the mail
+ system that hosts Mailman has trouble keeping up.
To test if this is a case, try visiting the list's web interface and
try sending a message to [EMAIL PROTECTED] with the command
- "\var{help}" (without the quotes) in the \mailheader{Subject}. If
+ ``\var{help}'' (without the quotes) in the \mailheader{Subject}. If
neither of these works after a reasonable length of time, this may be
the problem. You may wish to contact either the list or site
administrator(s).
@@ -901,7 +918,7 @@
\subsection{How can I start or stop getting the list posts grouped into one
big email? (digest option)\label{sec:digest}}
-Groups of posts are called "digests" in Mailman. Rather than get messages
+Groups of posts are called ``digests'' in Mailman. Rather than get messages
one at a time, you can get messages grouped together. On a moderately busy
list, this typically means you get one email per day, although it may be
more or less frequent depending upon the list.
@@ -913,10 +930,10 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Set Digest Mode."
+ \item Look for the section marked ``Set Digest Mode.''
- Set it to "On" to
- receive messages bundled together in digests. Set it to "Off" to
+ Set it to ``On'' to
+ receive messages bundled together in digests. Set it to ``Off'' to
receive posts separately.
\end{enumerate}
@@ -929,8 +946,8 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item 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.
+ \item 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~\ref{sec:MIME} for more information on plain versus MIME
digests.
\end{enumerate}
@@ -963,9 +980,9 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Get MIME or Plain Text Digests?."
+ \item 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
+ Set it to ``MIME'' to receive digests in MIME format, or ``Plain text'' to
receive digests in plain text format.
\end{enumerate}
@@ -982,8 +999,8 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "plain" to get posts bundled into a plain text digest,
- or "mime" to get posts bundled together into a MIME digest.
+ \item Set it to ``plain'' to get posts bundled into a plain text digest,
+ or ``mime'' to get posts bundled together into a MIME digest.
\end{enumerate}
% ----------------------------------------------------------------------------
@@ -994,13 +1011,13 @@
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
+Each of the courses being run is associated with 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 with
-the correct topic. Usually, this means adding a tag of some type to the
+the correct topic. Usually, this means adding a word or tag of some type to the
subject line (eg: [Networking] What type of cables do I need?) or making
sure the \mailheader{Keywords} line has the right information. (By default,
you can put a \mailheader{Keywords} section in the beginning of the body
@@ -1014,21 +1031,26 @@
When a list administrator defines a topic, he or she sets three things:
\begin{itemize}
\item a topic name
- \item a regular expression (regexp)
+ \item a regular expression (regexp.)
\item a description
\end{itemize}
You can view this information by logging in to your member options page.
(See Section~\ref{sec:web} for more details on how to do this.) and
-clicking on the "details" link for any topic that interests you.
+clicking on the ``details'' link for any topic that interests you.
To post on a given topic, you need to make sure that the
\mailheader{Keywords} or \mailheader{Subject} headers in a message
match the \emph{regular expression} for that topic.
+A regular expression is a pattern which may match more than one thing.
Regular expressions can actually be fairly complex, so you may want to
just ask the list administrator if you don't know how to make
heads or tails of the expression given.
+If you really want to know more about regular expressions, read on, but for the
+most part, your list administrator should include in the topic description what
+you need to add to your Keywords or Subject line to match the topic pattern.
+
Most Mailman topic expressions will be fairly simple regular expressions, so
in this document we will simply give you some common examples. Regular
expressions are a bit too complex to teach in a few lines here, so if you
@@ -1058,9 +1080,9 @@
\item The matching is case-insensitive, so if zuff matches, so will ZUFF,
zuFF, and any other variations in capitalization.
\item Some characters have special meaning in a regular expression, so
- to match those characters specifically, they must be "escaped" with a
+ to match those characters specifically, they must be ``escaped'' with a
backslash (\textbackslash). As you can see in the above example,
- [ and ] are such characters. (Others include ".", "?", and "*").
+ [ 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
@@ -1081,8 +1103,8 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Which topic categories would you like
- to subscribe to?"
+ \item 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
@@ -1095,6 +1117,8 @@
% ----------------------------------------------------------------------------
\subsection{How do I get or avoid getting messages with no topic set?
\label{sec:notopic}}
+Some messages will not match any predefined topic pattern. You can choose to
+receive or ignore such non-matching messages.
If you wish to get all messages sent to the list, make sure you are
not subscribed to any specific topic. (See Section~\ref{sec:sometopic}.)
@@ -1106,11 +1130,11 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item Look for the section marked "Do you want to receive message that do
- not match any topic filter?"
+ \item 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."
+ If you wish to receive messages with no topic set, select ``Yes.'' If you
+ do not wish to receive such messages, choose ``No.''
\end{enumerate}
This setting has no effect if you are not subscribed to any topics.
@@ -1123,10 +1147,10 @@
\label{sec:global}}
For some of the options given in your member options page, there is a
-tick-box which says "Change Globally" or "Set Globally."
+checkbox 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.
+option, you can also have the change made for all your other
+subscriptions 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.
@@ -1139,7 +1163,7 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web}
for more details on how to do this.)
- \item In the section marked "Changing your LISTNAME membership information,"
+ \item In the section marked ``Changing your LISTNAME membership information,''
enter your new name in the appropriate box.
\end{enumerate}
@@ -1152,10 +1176,13 @@
% ----------------------------------------------------------------------------
\subsection{How do I set my preferred language?}
-Mailman is available with many different languages.
-(For a complete listing see \url{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.
+Mailman is multi-lingual, meaning its interface has been translated to many
+different languages. Your list administrator can enable various languages for
+their use when interacting with Mailman.
+(For a complete listing of the languages see
+\url{http://www.list.org/i18n.html}.) 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
@@ -1170,7 +1197,7 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web} for
instructions on how to do this.)
- \item Go to the section marked "What language do you prefer?" and choose
+ \item Go to the section marked ``What language do you prefer?'' and choose
the appropriate language from the drop-down list. If there is no
drop-down list of languages, the list you are on probably only supports
one language.
@@ -1184,10 +1211,13 @@
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 \url{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.")
+list at \url{http://mail.python.org/mailman/listinfo/mailman-i18n}. The
+current status of internationalization efforts is available at
+\url{http://www.list.org/i18n.html}.
+
+\note{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.''}
% ----------------------------------------------------------------------------
\subsection{How do I avoid having my name appear on the subscribers list?
@@ -1198,7 +1228,7 @@
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
+but if you feel this is insufficient it's easy enough to remove your 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~\ref{sec:antispam} for more information on what
@@ -1208,8 +1238,8 @@
\begin{enumerate}
\item Log in to your member options page. (See Section~\ref{sec:web} for
instructions on how to do this.)
- \item Go to the section marked "Conceal yourself from subscriber list?" and
- choose "Yes" to hide your name from the list, or "No" to allow your name
+ \item Go to the section marked ``Conceal yourself from subscriber list?'' and
+ choose ``Yes'' to hide your name from the list, or ``No'' to allow your name
to appear on the list.
\end{enumerate}
@@ -1222,8 +1252,8 @@
in either the body or the subject of the message. (See
Section~\ref{sec:email} for more information about sending mail
commands.)
- \item Set it to "on" to conceal your email address from the membership
- list, or "off" to stop concealing your address.
+ \item Set it to ``on'' to conceal your email address from the membership
+ list, or ``off'' to stop concealing your address.
\end{enumerate}
% ============================================================================
@@ -1231,13 +1261,13 @@
% ----------------------------------------------------------------------------
\subsection{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 \mailheader{List-Archive} of every list message unless your list
-administrator has disabled these headers. (Many mail programs hide the
-\mailheader{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.)
+If the list is being archived, previously posted messages can be viewed by
+going to the archive's web pages, a link to which can be found on the list
+information page and in the \mailheader{List-Archive} header of every posted
+message (unless your list administrator has disabled such headers).
+Many mail programs hide the \mailheader{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
\url{http://WEBSERVER/pipermail/LISTNAME/} and private archives usually
@@ -1261,7 +1291,7 @@
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
+particular list may be set up in different ways. List administrators
must walk a fine line between protecting subscribers and making it difficult
for people to get in touch.
@@ -1288,7 +1318,10 @@
obscured addresses. Other archiving programs are available
and can
do different levels of obfuscation to make addresses less
readable.
\item If you wish to be more sure, you can set the mail header
- \mailheader{X-no-archive} and Mailman will not archive your
posts.
+ ``\mailheader{X-No-archive} yes'' and Mailman will not archive
your
+ posts. Similarly, you can set the mail header
+ ``\mailheader{X-Archive} no'' to disable archiving.
+
\warning{This does not stop other members from quoting your
posts,
possibly even including your email address.}
\end{itemize}
_______________________________________________
Mailman-checkins mailing list
[EMAIL PROTECTED]
http://mail.python.org/mailman/listinfo/mailman-checkins
