home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / maillist / !MailList_Docs_MailingLst < prev    next >
Encoding:
Text File  |  1995-04-07  |  7.2 KB  |  143 lines
  1. Using the Mailing-List Robot
  2. ============================
  3.  
  4. Creating a mailing-list
  5. -----------------------
  6.  
  7. After you have installed MailList on your <host> you may want to create a
  8. mailing-list.  
  9.  
  10. 1. Choose a name <listname> for the mailing-list. The length of the name is
  11.    restricted by the filing system. However, it is possible to define a
  12.    longer listname than the filing system would allow. See below for more
  13.    details.
  14.  
  15. 2. Send the request CREATE <listname> to MailList. The request must be sent
  16.    from your root-account. Otherwise, MailList will refuse to process your
  17.    request.
  18.  
  19. 3. MailList will process the request and send a confirmation to root@<host>
  20.    and <listname>@<host>
  21.  
  22. 4. Next you should define the list-owner. From your root-account send the
  23.    request: OWNER <listname> <list-owner>
  24.    Here <list-owner> must be the *FULL* RFC-822 address of the person who
  25.    will be maintaining the list. Even if this person is on the same <host>
  26.    you MUST include the domain-part (<host>) of the Internet address.
  27.    Usually this could be you.
  28.  
  29. 5. MailList will send the <list-owner> instructions to finish the
  30.    mailing-list installation. Typically this will be defining the list's
  31.    configuration and Charter. And announcing the existance of the list
  32.    through the usual channels.
  33.  
  34.  
  35. Configuring a mailing-list
  36. --------------------------
  37.  
  38. When the mailing-list has been created as described above the <list-owner>
  39. can finish the configuration of the mailing-list.
  40.  
  41. 1. Define the list's Charter. This is a description of the purpose of the
  42.    list. Who it is intended for and things like that. To define the Charter
  43.    the <list-owner> sends the request: CHARTER <listname>
  44.    In this case the body of the message is assumed to contain the Charter.
  45.    MailList will strip the message-header and any signature from the message
  46.    and store the rest of the message as the list's Charter. Note, however,
  47.    that MailList can only remove the signature if it is USEnet compliant.
  48.    I.e. '-- ' at the start of the first line of the signature.
  49.  
  50. 2. Define the list's options (Request: DEFINE <list> <option>):
  51.         DIGEST or NODIGEST
  52.         Default: NODIGEST
  53.                 By default messages processed by the list are redistributed
  54.                 individually to the subscribers. When DIGEST is set messages
  55.                 are gathered and put in a single file called a digest. When
  56.                 the digest becomes bigger than 90kB or grows older than 7
  57.                 days the file is sent to the subscribers. This is especially
  58.                 useful when NEWSFEED is configured.
  59.         MAILFEED or NEWSFEED <group>
  60.         Default: MAILFEED
  61.                 By default messages sent to <listname>@<host> are
  62.                 redistributed to the subscribers. It is possible to
  63.                 distribute a USEnet newsgroup *instead of* messages from
  64.                 subscribers. NEWSFEED <group> will distribute the newsgroup
  65.                 <group> (eg. comp.sys.acorn) to the subscribers. When
  66.                 NEWSFEED is configured messages sent to the list are not
  67.                 processed.
  68.         MODERATOR or NOMODERATOR
  69.         Default: NOMODERATOR
  70.                 By default messages sent to <listname>@<host> are
  71.                 redistributed to the subscribers automatically. You may find
  72.                 that some lists are prone to very low Signal/Noise
  73.                 ratios. I.e. Lots of noise and little interesting articles.
  74.                 To keep the noise down (or for some other reason) you may
  75.                 want to define the list as a moderated list. When the list
  76.                 is defined MODERATOR all articles sent to it are first sent
  77.                 to the ListOwner. The ListOwner can then read the article
  78.                 first. If he judges that the article is not fit for
  79.                 distribution he does nothing. To tell the MailList Robot
  80.                 that the article may be distributed to the subscribers the
  81.                 ListOwner can use the request: APPROVE <list> <#>. Where
  82.                 <list> is the name of the mailing-list and <#> is the
  83.                 article number given by the robot.
  84.  
  85. 3. Announce the existence of the list through the appropriate channels.
  86.    Among others the <list-owner> should at least announce the list via
  87.    the BITNET mailing-list NEW-LIST. Send e-mail to 
  88.         LISTSERV@VM1.NODAK.EDU
  89.    for more information. In the body of the message put:
  90.         GET NEW-LIST README                     (case-sensitive!!)
  91.         GET NEW-LIST CREATE
  92.         GET NEW-LIST FORMAT
  93.  
  94.    Alternatively you can download these files from the Mail-Server at the
  95.    'Home of the MailList Robot'. Send the request SEND INDEX to
  96.    'maillist@cray-3.xs4all.nl' to find out where they are stored.
  97.  
  98. 4. Long Listnames
  99.    MailList supports listnames that are longer that the Filing System
  100.    allows. This is achieved by truncating the listname to the supported
  101.    length. To fool subscribers the request LISTS can be made to return the
  102.    long listname instead of the truncated name. This is achieved by setting
  103.    the RL Name in !TTFN. Doing this will create a file 'RLN' in the
  104.    mailing-lists UserHome directory. !MailList accesses this file by trying
  105.    to read the <UserHome$Dir>.<listname>.RLN. If it exists ONLY the first
  106.    line in this file will be included in the response.
  107.  
  108. 5. Using the above (4) method you can also choose to define a short 
  109.    description of the list. Using !TTFN define the RL Name; enter the
  110.    listname and a short description; click on "Set". LISTS will return the
  111.    first line of the RLN file (if it exists) instead of the listname.
  112.    NOTE: This feature has the added advantage (?) that you can hide the
  113.          existance of a mailing-list to the outside world by setting an
  114.          empty RLN.
  115.  
  116. 6. MOTD & MF1D
  117.    A MOTD (Messages Of The Day) can be included in every article sent out
  118.    for a given mailing-list. To do this create a file called MOTD in the
  119.    directory (!NewsDir.MailList.Lists.<listname>) of the list. In the file
  120.    you can define a message which you want to append to each distributed
  121.    article of the mailing-list. This can be a disclaimer or up-to-date
  122.    information or whatever.
  123.    The MOTD is appended to the end of a message or at the beginning of a
  124.    digest.
  125.    Sometimes you want to distribute a message only once. So distributing it
  126.    with the next article is enough. For this purpose is the MF1D (Message
  127.    For 1 Day) which is appended like the MOTD to the next article being
  128.    distributed for the mailing-list. However, once the MF1D has been
  129.    appended to an article it is deleted. To use this create a file called
  130.    MF1D in the forementioned directory.
  131.  
  132. *&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*
  133.  
  134.   There is an FAQ about Acorn-related mailing-lists which is posted
  135.   regularly to comp.sys.acorn.announce. This FAQ can be retrieved from the
  136.   forementioned MailServer by sending the request SEND FAQ.AcornLists 
  137.   If your mailing-list is Acorn-related you might like to have it added to
  138.   the FAQ. Just send me a message at <mhe@cray-3.xs4all.nl> and let me know:
  139.  
  140.         * name & charter of the mailing-list
  141.         * subscription information
  142.  
  143. *&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*&*