* Finish rewrite of users.rst doctest.
[mailman.git] / README.rst
blobc87b7eccbb74babbcdc8c461dba61ae13096f792
1 ================================================
2 Mailman - The GNU Mailing List Management System
3 ================================================
5 Copyright (C) 1998-2012 by the Free Software Foundation, Inc.
7 This is GNU Mailman, a mailing list management system distributed under the
8 terms of the GNU General Public License (GPL) version 3 or later.  The name of
9 this software is spelled "Mailman" with a leading capital 'M' but with a lower
10 case second 'm'.  Any other spelling is incorrect.
12 Mailman is written in Python which is available for all platforms that Mailman
13 is supported on, including GNU/Linux and most other Unix-like operating
14 systems (e.g. Solaris, \*BSD, MacOSX, etc.).  Mailman is not supported on
15 Windows, although web and mail clients on any platform should be able to
16 interact with Mailman just fine.
18 The Mailman home page is:
20     http://www.list.org
22 and there is a community driven wiki at
24     http://wiki.list.org
26 For more information on Mailman, see the above web sites, or the documentation
27 provided with this software.  Start at src/mailman/docs/README.txt.
30 Table of Contents
31 =================
33 .. toctree::
34     :glob:
36     src/mailman/docs/INTRODUCTION
37     src/mailman/docs/START
38     src/mailman/docs/DATABASE
39     src/mailman/docs/MTA
40     src/mailman/docs/8-miles-high
41     src/mailman/docs/WebUIin5
42     src/mailman/docs/ArchiveUIin5
45 Mailman modules
46 ---------------
48 These documents are generated from the doctest suite.
50 .. toctree::
51     :glob:
53     src/mailman/bin/docs/*
54     src/mailman/commands/docs/*
55     src/mailman/database/docs/*
56     src/mailman/model/docs/*
57     src/mailman/core/docs/*
58     src/mailman/app/docs/*
59     src/mailman/styles/docs/*
60     src/mailman/runners/docs/*
61     src/mailman/handlers/docs/*
62     src/mailman/rest/docs/*
63     src/mailman/chains/docs/*
64     src/mailman/rules/docs/*
65     src/mailman/archiving/docs/*
66     src/mailman/mta/docs/*
67     src/mailman/docs/NEWS
68     src/mailman/docs/STYLEGUIDE
69     src/mailman/docs/ACKNOWLEDGMENTS
72 Indices and tables
73 ==================
75 * :ref:`genindex`
76 * :ref:`modindex`
77 * :ref:`search`