Fix docs build.
[mailman.git] / src / mailman / docs / README.txt
blob063ff55836d6725fc393c856b2c62cdac226bf65
1 ================================================
2 Mailman - The GNU Mailing List Management System
3 ================================================
5 This is `GNU Mailman`_, a mailing list management system distributed under the
6 terms of the `GNU General Public License`_ (GPL) version 3 or later.
8 Mailman is written in Python_, a free object-oriented programming language.
9 Python is available for all platforms that Mailman is supported on, which
10 includes GNU/Linux and most other Unix-like operating systems (e.g. Solaris,
11 \*BSD, MacOSX, etc.).  Mailman is not supported on Windows, although web and
12 mail clients on any platform should be able to interact with Mailman just
13 fine.
16 Copyright
17 =========
19 Copyright 1998-2009 by the Free Software Foundation, Inc.
21 This file is part of GNU Mailman.
23 GNU Mailman is free software: you can redistribute it and/or modify it under
24 the terms of the GNU General Public License as published by the Free Software
25 Foundation, either version 3 of the License, or (at your option) any later
26 version.
28 GNU Mailman is distributed in the hope that it will be useful, but WITHOUT ANY
29 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
30 A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
32 You should have received a copy of the GNU General Public License along with
33 GNU Mailman.  If not, see <http://www.gnu.org/licenses/>.
36 Spelling
37 ========
39 The name of this software is spelled `Mailman` with a leading capital `M`
40 but with a lower case second `m`.  Any other spelling is incorrect.  Its full
41 name is `GNU Mailman` but is often referred colloquially as `Mailman`.
44 History
45 =======
47 Mailman was originally developed by John Viega.  Subsequent development
48 (through version 1.0b3) was by Ken Manheimer.  Further work towards the 1.0
49 final release was a group effort, with the core contributors being: Barry
50 Warsaw, Ken Manheimer, Scott Cotton, Harald Meland, and John Viega.  Version
51 1.0 and beyond have been primarily maintained by Barry Warsaw with
52 contributions from many; see the ACKNOWLEDGMENTS file for details.  Jeremy
53 Hylton helped considerably with the Pipermail code in Mailman 2.0.  Mailman
54 2.1 is now being primarily maintained by Mark Sapiro and Tokio Kikuchi.  Barry
55 Warsaw is the lead developer on Mailman 3.
58 Help
59 ====
61 The Mailman home page is:
63     http://www.list.org
65 with mirrors at:
67     http://www.gnu.org/software/mailman
68     http://mailman.sf.net
70 The community driven wiki (including the FAQ_) is at:
72     http://wiki.list.org
74 Other help resources, such as on-line documentation, links to the mailing
75 lists and archives, etc., are available at:
77     http://www.list.org/help.html
79 For more information about the alpha releases, see `ALPHA.txt`_.
82 Requirements
83 ============
85 Mailman 3.0 requires `Python 2.6`_ or newer.
88 .. _`GNU Mailman`: http://www.list.org
89 .. _`GNU General Public License`: http://www.gnu.org/licenses/gpl.txt
90 .. _Python: http://www.python.org
91 .. _FAQ: http://wiki.list.org/display/DOC/Frequently+Asked+Questions
92 .. _`Python 2.6`: http://www.python.org/download/releases/2.6.2/
93 .. _`ALPHA.txt`: ALPHA.html
96 Table of Contents
97 =================
99 .. toctree::
100     :glob:
102     *
103     ../bin/docs/*
104     ../commands/docs/*
105     ../pipeline/docs/*
106     ../queue/docs/*
107     ../rest/docs/*
108     ../rules/docs/*
109     ../archiving/docs/*
110     ../mta/docs/*