Merge branch 'docs' into 'master'
[mailman.git] / README.rst
blob485b266d34eb0c623b5b68efc50aa999f9f9863c
1 ================================================
2 Mailman - The GNU Mailing List Management System
3 ================================================
5 .. image:: https://gitlab.com/mailman/mailman/badges/master/build.svg
6     :target: https://gitlab.com/mailman/mailman/commits/master
8 .. image:: https://readthedocs.org/projects/mailman/badge
9     :target: https://mailman.readthedocs.io
11 .. image:: http://img.shields.io/pypi/v/mailman.svg
12     :target: https://pypi.python.org/pypi/mailman
14 .. image:: http://img.shields.io/pypi/dm/mailman.svg
15     :target: https://pypi.python.org/pypi/mailman
17 Copyright (C) 1998-2017 by the Free Software Foundation, Inc.
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.
24 Mailman is written in Python which is available for all platforms that Mailman
25 is supported on, including GNU/Linux and most other Unix-like operating
26 systems (e.g. Solaris, \*BSD, MacOSX, etc.).  Mailman is not supported on
27 Windows, although web and mail clients on any platform should be able to
28 interact with Mailman just fine.
30 The Mailman home page is:
32     http://www.list.org
34 and there is a community driven wiki at
36     http://wiki.list.org
38 For more information on Mailman, see the above web sites, or the
39 :ref:`documentation provided with this software <start-here>`.
42 Table of Contents
43 =================
45 .. toctree::
46     :glob:
47     :maxdepth: 1
49     src/mailman/docs/introduction
50     src/mailman/docs/release-notes
51     src/mailman/docs/install
52     src/mailman/config/docs/config
53     src/mailman/docs/database
54     src/mailman/docs/mta
55     src/mailman/docs/postorius
56     src/mailman/docs/hyperkitty
57     src/mailman/docs/contribute
58     src/mailman/docs/STYLEGUIDE
59     src/mailman/docs/architecture
60     src/mailman/docs/8-miles-high
63 Mailman modules
64 ---------------
66 These documents are generated from the internal module documentation.
68 .. toctree::
69     :maxdepth: 1
71     src/mailman/model/docs/model
72     src/mailman/runners/docs/runners
73     src/mailman/chains/docs/chains
74     src/mailman/rules/docs/rules
75     src/mailman/handlers/docs/handlers
76     src/mailman/rest/docs/rest
77     src/mailman/core/docs/core
78     src/mailman/app/docs/app
79     src/mailman/styles/docs/styles
80     src/mailman/archiving/docs/common
81     src/mailman/mta/docs/mta
82     src/mailman/bin/docs/master
83     src/mailman/commands/docs/commands
84     src/mailman/docs/NEWS
85     src/mailman/docs/ACKNOWLEDGMENTS
86     contrib/README
89 Indices and tables
90 ==================
92 * :ref:`genindex`
93 * :ref:`modindex`
94 * :ref:`search`