## [%|helploc%]Mailing lists - User Guide[%END%]

### [%|helploc%]How the mailing list service works[%END%]

[%|helploc%]The mailing-list service is managed by a mailing-list software: Sympa. This software comes with a web mailing list environment.[%END%]

[%|helploc%]To perform actions related to mailing lists (subscribe, change your options, etc.), you have two options:[%END%]

- [%|helploc%]log on to the web environment;[%END%]
- [%|helploc(conf.email,conf.host)%]send commands by email to the Sympa mailing list manager at %1@%2.[%END%]

[%|helploc%]To send a command to Sympa, do as follows:[%END%]

- [%|helploc%]If you send a single command, type it into the subject line of your email and leave its body blank.[%END%]
- [%|helploc%]If you send several commands, leave the subject line of your email blank and type all the commands in the email body. Be careful: Sympa will not process your message unless you respect the following rules:[%END%]
  - [%|helploc%]Write every command on a new line.[%END%]
  - [%|helploc%]Send your message in plain text, not in HTML (no formatting).[%END%]
  - [%|helploc%]Your message can not contain anything else than Sympa commands (no signature block).[%END%]

[%|helploc(path_cgi)%]A description of all the commands you can send to Sympa is available at %1/help/mail_commands.[%END%]

### [%|helploc%]Subscribing to mailing lists[%END%]

[%|helploc%]Subscribing to a mailing list is very simple:[%END%]

1. [%|helploc%]Choose the address with which you want to subscribe to the list.[%END%]

   [%|helploc%]You should choose an address you can check frequently and which offers a large storage capacity for your email: some lists distribute many messages, which sometimes contain large attachments.[%END%]

   [%|helploc%]Of course you can subscribe to the same list with several email addresses. Then you will need to redo the whole process with a different email address.[%END%]

2. [%|helploc(conf.email,conf.host)%]Send a message to %1@%2 from the address you want to subscribe to the list.[%END%]

   [%|helploc%]Sympa is not a person but a mailing list management robot. Thus it is useless to send it loving words! ;-)[%END%]

3. [%|helploc%]In the subject line of your message, type in: subscribe nameofthelist Firstname Name (replace 'nameofthelist' by the name of the list you want to subscribe to and indicate your own first name and name).[%END%]
4. [%|helploc%]Leave the message body blank.[%END%]

   [%|helploc%]To save some time, you can also send several commands in a single message. To do that, follow the instructions available in the How the mailing list service works section.[%END%]

[%|helploc(conf.host)%]After this, you will receive a message telling you whether your request was accepted or not: if the subscription to the list is subject to any approval, the list owner may choose not to subscribe you. If so, do not send several other requests: it is useless as the result will remain the same. You can possibly send a message directly to the list owner (nameofthelist-request@%1) to explain why you really want to subscribe to the list...[%END%]

[%|helploc%]Note: you will sometimes be asked to confirm your subscription request before it can be processed. If so, please conform to the instructions contained in the message you receive.[%END%]

[%|helploc%]According to the type of list (list with subscription subject to conditions or not) and to the availability of the list owner, you may not receive the notice immediately. It is useless to send several requests.[%END%]

[%|helploc%]If your request is accepted, the message you receive confirms your subscription to the list. This message (the list Charter) contains several pieces of essential information:[%END%]

- [%|helploc%]your list password. This password is the same for all the lists you subscribed to with a single email address. You can change it online after logging on to the mailing list environment;[%END%]
- [%|helploc%]detailed information about the list: its purpose, the Internet address at which the message archive is available, etc.[%END%]
- [%|helploc%]the rules applying to the list and its members: allowed and forbidden topics, netiquette, legal information, privacy policy, etc.[%END%]

[%|helploc%]You should keep your subscription notice: you may need it later to remember your password or to send a precise command to Sympa (example: signoff command). More generally, we advise you to keep all your subscription notices to mailing lists.[%END%]

[%|helploc%]You can also subscribe to a list through the mailing list web interface. To do that, do as follows:[%END%]

1. [%|helploc(path_cgi)%]Go to the list environment homepage and log on.[%END%]
2. [%|helploc%]Go to the information page of the list you want to subscribe to.[%END%]
3. [%|helploc%]In the left menu, click on the 'Subscribe' link.[%END%]

### [%|helploc%]Logging on to the mailing list environment[%END%]

[%|helploc%]To log on to the mailing list environment, use the authentication form displayed on top of the left column of the web interface. When you are logged on, your email address and user profile (subscriber, moderator or owner) are displayed there.[%END%]

[%|helploc%]The authentication process varies according to your personal situation:[%END%]

- [%|helploc%]If the organization offering the mailing list service uses single sign-on technology (unique account and unique authentication, for example through the CAS system), you will preferably log on with your unique account. To do that, click on the 'Go' button next to the text 'Authentication [name of the system used]'. Then, type in your login and password to log on to the authentication server.[%END%]

  [%|helploc%]If you have already logged on to another service using the unique authentication system, your authentication is automatic. Refresh page if necessary.[%END%]

- [%|helploc%]If the unique authentication process does not apply to you but you are already subscribed to lists, then you have been granted a list password (displayed in the list Charter you got when you susbcribed to the list). In this case, log on through the classic method: enter the email address with which you subscribed to the list as a login and your list password in the 'Password' field.[%END%]

  [%|helploc%]If you do not remember your list password, click on 'Lost password ?'. Then you will need to enter your email address and your password will be sent at that address.[%END%]

- [%|helploc%]If the unique authentication process does not apply to you and you do no have a list password yet, click on 'First login ?' and type in your email address. Your new password will be sent at that address. Then you will be able to log on by typing your email address as a login and your list password in the 'Password' field.[%END%]

[%|helploc%]Remember: the list password is a special password you will only use for the mailing list service.[%END%]

### [%|helploc%]Checking your subscriptions[%END%]

[%|helploc%]To see all the lists you subscribed to, you need to log on first. Then a list of all your lists, including a short description for each of them, will be displayed in the 'Your lists' form on the left column.[%END%]

[%|helploc%]To look at a list information page, click on its name. The information page includes a description of the list (object, rules applying when sending a message, etc.), which length varies according to the list.[%END%]

[%|helploc%]Form this information page, you can:[%END%]

- [%|helploc%]change your subscriber options;[%END%]
- [%|helploc(path_cgi)%]read the list archive;[%END%]
- [%|helploc(path_cgi)%]search in the message archive;[%END%]
- [%|helploc(path_cgi)%]send new messages;[%END%]
- [%|helploc(path_cgi)%]download documents from the shared document web space;[%END%]
- [%|helploc(path_cgi)%]upload documents in the shared document web space;[%END%]
- [%|helploc%]review members of the list (if available);[%END%]
- [%|helploc%]unsubscribe from the list.[%END%]

[%|helploc%]The number of people subscribed to the list is permanently displayed in the left menu. To review the list members, click on the 'Review members' link in the left menu (if the list-owner decided to deny access to the members list, this link is not available). The subscribers list displays and shows the email address and name of each of the subscribers (the indication of the name depends on the subscription method used by the subscribers).[%END%]

[%|helploc%]By default, each page displays 25 subscribers. You can browse through the pages by using the browsing arrows or display more subscribers per page. You may also wish to sort subscribers according to their email address, domain or name by clicking on the corresponding column header.[%END%]

[%|helploc(conf.host)%]The names of the list owners and moderators are displayed in the left menu. You should never write directly to a list owner or moderator. If you want to ask a question or make a comment, you should use the following address: nameofthelist-request@%1 (replace 'nameofthelist' by the name of the list in question).[%END%]

[%|helploc%]To know when you subscribed to the list and when you last updated your subscriber options, click on the 'Subscriber options' link in the left menu.[%END%]

### [%|helploc%]Managing your preferences[%END%]

[%|helploc%]To allow you to use lists more easily, you can define a number of personal preferences. There are two types of preferences you can change:[%END%]

- [%|helploc%]your subscriber options, which can vary according to the list;[%END%]
- [%|helploc%]your general preferences, which apply to the entire Sympa mailing list environment.[%END%]

#### [%|helploc%]Changing your subscriber options[%END%]

[%|helploc%]Your subscriber options can vary from a list to another. To change them, do as follows:[%END%]

1. [%|helploc(path_cgi)%]Go to the list environment homepage and log on.[%END%]
2. [%|helploc%]Go to the information page of the list for which you want to change your subscriber options.[%END%]
3. [%|helploc%]In the left menu, click on the 'Subscriber options' link.[%END%]
4. <[%|helploc%]strong>Choose a message delivery mode (those options are mutually exclusive, thus you can not select several of them):[%END%]
   - [%|helploc%]digest MIME format: instead of receiving the list messages in a normal manner, you will get a digest of them on a regular basis. This digest compiles a group of messages from the list, using multipart/digest MIME format. The digest frequency is set up by the list owner.[%END%]
   - [%|helploc%]digest plain text format: instead of receiving the list messages in a normal manner, you will get a digest of them on a regular basis. This digest compiles a group of messages from the list, using plain text format. The digest frequency is set up by the list owner.[%END%]
   - [%|helploc%]summary mode: instead of receiving the list messages in a normal manner, you will get a list of them on a regular basis. To read the messages, you will need to browse the online list archive.[%END%]
   - [%|helploc%]notice mode: with this mode, you will receive all the messages with a blank body: this way you are informed of every message sent to the list real time, without risk of flooding your inbox.[%END%]
   - [%|helploc%]no mail (useful for vacations): this mode makes it possible not to receive the messages of the list. It is especially useful when you have no access to your email for a long time and want to remain subscribed to the list nevertheless.[%END%]
   - [%|helploc%]text only mode: this mode allows you to receive only the text version (text/plain) of messages sent in both formats (plain text and HTML).[%END%]
   - [%|helploc%]HTML only mode: this mode allows you to receive only the HTML version (text/html) of messages sent in both formats.[%END%]
   - [%|helploc%]urlize mode: this mode allows you not to receive attached documents. However these documents are available in the list archive and you can access them through a URL provided in the message.[%END%]
   - [%|helploc%]you do not receive your own posts: this mode allows you not to receive a copy of your own messages.[%END%]
   - [%|helploc%]standard (direct reception): this mode is the default delivery mode; it cancels any other delivery mode.[%END%]
5. [%|helploc%]Choose a visibility option:[%END%]
   - [%|helploc%]listed in the list review page: your name and email address will be displayed in the members list (if the list owner allowed subscribers to review the list members).[%END%]
   - [%|helploc%]concealed: your name and email address will not be displayed in the members list. However you email address will be visible in the list archive if you send messages.[%END%]
6. [%|helploc%]Click on the 'Update' button.[%END%]

#### [%|helploc%]Changing your general preferences[%END%]

[%|helploc%]The general preferences apply to all your subscriptions as well as to the way your Sympa mailing list web interface displays. To change your preferences, do as follows:[%END%]

1. [%|helploc(path_cgi)%]Go to the list environment homepage and log on.[%END%]
2. [%|helploc%]In the form displayed on top of the left column, click on the 'Your preferences' link.[%END%]
3. [%|helploc%]Change your preferences.[%END%]
4. [%|helploc%]Click on 'Submit' for every option you change.[%END%]

[%|helploc%]You can change:[%END%]

- [%|helploc%]your name; if you subscribe to a list from the mailing list server web interface, the 'Name' field will automatically be filled in in the members list;[%END%]
- [%|helploc%]the language in which the Sympa web interface is displayed (you can change language on every page of the web interface; your choice will remain even though you change the interface language on another page than the 'Preferences' page;[%END%]
- [%|helploc%]the lifetime of the cookie placed on your computer by Sympa ('Connection expiration period'). By default, the session expires when you close your browser; if you use the mailing list service a lot, we advise you to choose a longer duration;[%END%]

  [%|helploc%]A cookie is a small file a web server stores on your hard disk, most generally temporarily, in order to identify you as a user of its service. It contains a few pieces of personal information about you: name, email address, latest logon time, etc.[%END%]

- [%|helploc%]the email address with which you subscribed to the lists (if you subscribed with several email addresses, the address to be replaced will be the one you logged on with);[%END%]

  [%|helploc%]Be careful: this will change your subscriptions to all your lists. If you want to change address for a single mailing list, you had better unsubscribe from that list and subscribe again with the right email address.[%END%]

- [%|helploc%]your list password.[%END%]

[%|helploc%]The 'Your other email addresses' section acts like an email address change.[%END%]

### [%|helploc%]Searching for a mailing list[%END%]

[%|helploc%]You may need to search for a mailing list. To do that, you have three options:[%END%]

- [%|helploc(path_cgi)%]browse the different sections displayed on the list environment homepage;[%END%]
- [%|helploc%]search for a list via the search box: the searched string will return all the lists whose name or description matches your search criteria (descriptions of the lists generally consist of a short sentence);[%END%]
- [%|helploc(path_cgi)%]click on the 'List of lists' tab on top of page to display all available lists.[%END%]

[%|helploc%]According to the domain to which your email address belongs (example: cru.fr, fai.com, etc.) and to the location you log on from, you will not have access to the same lists. However you can subscribe to a list that does not display if you know its name. To do this, use your email client.[%END%]

### [%|helploc%]Reading a list archive online[%END%]

[%|helploc(path_cgi)%]Please refer to the archive documentation.[%END%]

### [%|helploc%]Sending a message[%END%]

[%|helploc(path_cgi)%]Please refer to the documentation about sending messages.[%END%]

### [%|helploc%]Using the shared document web space[%END%]

[%|helploc(path_cgi)%]Please refer to the shared document web space documentation.[%END%]

### [%|helploc%]Unsubscribing from lists[%END%]

[%|helploc%]To unsubscribe from a list, do as follows:[%END%]

1. [%|helploc(conf.email,conf.host)%]From the address with which you subscribed to the list, send a message to %1@%2.[%END%]
2. [%|helploc%]In the subject line of your email, type in: unsubscribe nameofthelist (replace 'nameofthelist' by the name of the list you want to unsubscribe from).[%END%]
3. [%|helploc%]Leave the message body blank.[%END%]

   [%|helploc%]To save some time, you can also send several commands in a single message. To do that, follow the instructions available in the How the mailing list service works section.[%END%]

[%|helploc%]You can also unsubscribe through the mailing list web interface (you will need to repeat the operation for each list you want to unsubscribe from):[%END%]

1. [%|helploc(path_cgi)%]Go to the list environment homepage and log on.[%END%]
2. [%|helploc%]Go to the information page of the list you want to unsubscribe from.[%END%]
3. [%|helploc%]In the left menu, click on the 'Unsubscribe' link.[%END%]