README.rst

   1 ================================================
   2 Mailman - The GNU Mailing List Management System
   3 ================================================
   4
   5 .. image:: https://gitlab.com/mailman/mailman/badges/master/build.svg
   6     :target: https://gitlab.com/mailman/mailman/commits/master
   7
   8 .. image:: https://readthedocs.org/projects/mailman/badge
   9     :target: https://mailman.readthedocs.io
  10
  11 .. image:: http://img.shields.io/pypi/v/mailman.svg
  12     :target: https://pypi.python.org/pypi/mailman
  13
  14 .. image:: http://img.shields.io/pypi/dm/mailman.svg
  15     :target: https://pypi.python.org/pypi/mailman
  16
  17 Copyright (C) 1998-2019 by the Free Software Foundation, Inc.
  18
  19 This is GNU Mailman, a mailing list management system distributed under the
  20 terms of the GNU General Public License (GPL) version 3 or later.  The name of
  21 this software is spelled "Mailman" with a leading capital 'M' but with a lower
  22 case second 'm'.  Any other spelling is incorrect.
  23
  24 Technically speaking, you are reading the documentation for Mailman Core.  The
  25 full `Mailman 3 suite <http://docs.mailman3.org>`_ includes a web user
  26 interface called Postorius, a web archiver called HyperKitty, and a few other
  27 components.  If you're looking for instructions on installing the full suite,
  28 read that documentation.
  29
  30 Mailman is written in Python which is available for all platforms that Mailman
  31 is supported on, including GNU/Linux and most other Unix-like operating
  32 systems (e.g. Solaris, \*BSD, MacOSX, etc.).  Mailman is not supported on
  33 Windows, although web and mail clients on any platform should be able to
  34 interact with Mailman just fine.
  35
  36 The Mailman home page is:
  37
  38     http://www.list.org
  39
  40 and there is a community driven wiki at
  41
  42     http://wiki.list.org
  43
  44 For more information on Mailman, see the above web sites, or the
  45 :ref:`documentation provided with this software <start-here>`.
  46
  47
  48 Table of Contents
  49 =================
  50
  51 .. toctree::
  52     :glob:
  53     :maxdepth: 1
  54
  55     src/mailman/docs/introduction
  56     src/mailman/docs/release-notes
  57     src/mailman/docs/install
  58     src/mailman/config/docs/config
  59     src/mailman/docs/database
  60     src/mailman/docs/mta
  61     src/mailman/docs/postorius
  62     src/mailman/docs/hyperkitty
  63     src/mailman/plugins/docs/intro
  64     src/mailman/docs/contribute
  65     src/mailman/docs/STYLEGUIDE
  66     src/mailman/docs/internationalization
  67     src/mailman/docs/architecture
  68     src/mailman/docs/8-miles-high
  69     src/mailman/docs/NEWS
  70     src/mailman/docs/ACKNOWLEDGMENTS
  71
  72
  73 Mailman modules
  74 ---------------
  75
  76 These documents are generated from the internal module documentation.
  77
  78 .. toctree::
  79     :maxdepth: 1
  80
  81     src/mailman/model/docs/model
  82     src/mailman/runners/docs/runners
  83     src/mailman/chains/docs/chains
  84     src/mailman/rules/docs/rules
  85     src/mailman/handlers/docs/handlers
  86     src/mailman/rest/docs/rest
  87     src/mailman/core/docs/core
  88     src/mailman/app/docs/app
  89     src/mailman/styles/docs/styles
  90     src/mailman/archiving/docs/common
  91     src/mailman/mta/docs/mta
  92     src/mailman/bin/docs/master
  93     src/mailman/commands/docs/commands
  94     contrib/README
  95
  96
  97 Indices and tables
  98 ==================
  99
 100 * :ref:`genindex`
 101 * :ref:`modindex`
 102 * :ref:`search`