debian/README.Debian

   1 mlmmj for Debian
   2 ----------------
   3
   4 INSTALLATION:
   5
   6 1) Configure a recipient delimiter. The default is to use '+'.
   7
   8    In postfix, add
   9      recipient_delimiter = +
  10    to /etc/postfix/main.cf
  11
  12    In Exim, add
  13      local_part_suffix = +*
  14      local_part_suffix_optional
  15    to the "userforward:" and the "localuser:" router in /etc/exim/exim.conf.
  16
  17    If you are using another MTA, please refer to its manual or
  18      http://faqs.org/faqs/mail/addressing/
  19    which has some very useful information.
  20
  21    This version of mlmmj supports setting the recipient delimiter on a
  22    per list basis. This is done by means of the TUNABLE "delimiter", described
  23    in detail in the TUNABLES document.
  24
  25 2) Run /usr/bin/mlmmj-make-ml which will guide you through creating the
  26    actual mailing list.
  27    Details about the exact operations of mlmmj-make-ml are available in
  28    /usr/share/doc/mlmmj/README.
  29
  30 3) If you didn't let mlmmj-make-ml modify /etc/aliases, you need to
  31    make the changes to your mailserver aliases that came as output from
  32    mlmmj-make-ml. Eg.
  33
  34    mlmmj-test:     | "/usr/bin/mlmmj-recieve -L /var/spool/mlmmj/mlmmj-test"
  35
  36 4) Mailing lists created by mlmmj-make-ml are owned by nobody:nogroup, unless
  37    the mlmmj-make-ml script is able to determine which MTA is handling your
  38    lists. If that is the case, it will set permissions accordingly, and check
  39    if any of your existing lists have seemingly wrong ownership.
  40    If default ownership is applied, you will need to tweak ownerships yourself.
  41
  42    The command to execute is:
  43
  44    chown -R <user> /var/spool/mlmmj/<listname>
  45
  46    where <user> is the user that applies to your MTA, and <listname> is the
  47    name of the list you just created.
  48    If you would like your MTA added to the list of automatically detected ones,
  49    please submit a bug against mlmmj in the Debian BTS (http://bugs.debian.org)
  50    and include the user/group information needed to make mlmmj work with your
  51    MTA.
  52
  53 5) Look through /usr/share/doc/mlmmj/TUNABLES to check the options available
  54    in mlmmj.
  55
  56 GENERAL NOTES:
  57
  58 * In order to comply with the FHS, the control and text subdirectories of each
  59   list, are created in /etc/mlmmj/lists/<listname> instead of under
  60   /var/spool/mlmmj/<listname>. Symlinks are created to keep functionality
  61   intact, so you should have no problems editing the files via their links
  62   under /var
  63 * Additionally, /use/share/doc/mlmmj/README.Debian has information on access
  64   control, moderation, archiving and lots of other features supported by
  65   mlmmj. You would do well to read it.
  66
  67 BUGS:
  68
  69 * The list-subscribers feature was added in mlmmj 1.2.5 and a new list text
  70   file was introduced accordingly. This file, called "listsubs" was not
  71   installed by the mlmmj-make-ml script before 1.2.5-1 and as such the list
  72   subscribers feature probably won't work in pre 1.2.5 lists, unless you
  73   copy /usr/share/mlmmj/text.skel/listsubs into
  74   /etc/mlmmj/lists/<listname>/text in all your pre 1.2.5 lists.
  75
  76  -- Søren Boll Overgaard <boll@debian.org>, Tue, 31 Aug 2004 17:47:15 +0000