summaryrefslogtreecommitdiff
path: root/docs/ALPHA.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ALPHA.txt')
-rw-r--r--docs/ALPHA.txt92
1 files changed, 0 insertions, 92 deletions
diff --git a/docs/ALPHA.txt b/docs/ALPHA.txt
deleted file mode 100644
index dec6a01a7..000000000
--- a/docs/ALPHA.txt
+++ /dev/null
@@ -1,92 +0,0 @@
-Mailman - The GNU Mailing List Management System
-Copyright (C) 2008-2009 by the Free Software Foundation, Inc.
-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
-
-ALPHA RELEASE
-
- The Mailman 3 alpha releases are being provided to give developers and
- other interested people an early look at the next major version. As such,
- many things may not work yet. Your participation is encouraged. Your
- feedback and contributions are welcome. Please submit bug reports on the
- Mailman bug tracker at
-
- https://bugs.launchpad.net/mailman
-
- or on the mailman-developers mailing list.
-
-
-USING THE ALPHA
-
- Python 2.6 is required. It can either be the default 'python' on your
- $PATH or it can be accessible via the 'python2.6' binary. See
- http://www.python.org for details on getting Python 2.6.
-
- Mailman 3 is now based on the zc.buildout infrastructure, which greatly
- simplifies building and testing Mailman.
-
- This version of Mailman depends on an unofficial branch of the lazr.config
- package. This branch adds a number of useful features and fixes some
- bugs, but it is still under review and not yet part of the official
- package. Start by checking out this unofficial branch:
-
- % cd wherever
- % bzr branch lp:~barry/lazr.config/megamerge
-
- Now you need to edit Mailman's buildout.cfg file. Look for the 'develop'
- line under the [buildout] section. Change the path to the megamerge
- package to point to the location of your checked out branch above.
-
- You will need the gettext package (specifically, the msgfmt(1) command) in
- order to build the I18N message catalogs. If you're missing this command,
- it is known that the digests.txt test will fail.
-
- You do not need anything other than Python 2.6 and an internet connection
- to get all the other Mailman 3 dependencies. Here are the commands to
- build everything:
-
- % python2.6 bootstrap.py
- % bin/buildout
-
- Now you can run the test suite via:
-
- % bin/test
-
- You should see no failures.
-
- At this point you can read the doctests by looking in all the 'doc'
- directories under the 'mailman' package. Doctests are documentation
- first, so they should give you a pretty good idea how various components
- of Mailman 3 works.
-
- What, you actually want to /run/ Mailman 3? Oh well, if you insist. You
- will need to set up a configuration file to override the defaults and set
- things up for your environment. Currently Mailman 3 is configured with a
- bastard mix of the old configuration system and lazr.config, which is an
- ini-style configuration system. Eventually all configuration will be
- converted to lazr.config.
-
- For now though, start by looking through src/mailman/config/schema.cfg.
- Create a file for your overrides; it can be called anything and can live
- anywhere, but I like to call it 'mailman.cfg'. For any value in
- schema.cfg you want to override, just add a section header (the
- square-bracketed names) and then the 'key: value' pair you want to
- override.
-
- You will need to pass the -C flag to any bin command you want to invoke,
- pointing it at your mailman.cfg file. The next release will make this
- simpler by searching some default locations.
-
- You can use the create_list, remove_list, list_lists, add_members, and
- list_members to set up and populate some mailing lists. You of course
- also need to use mailmanctl to start the queue runners, and then you can
- use the inject command to put some messages into the queue. For the most
- part, they ought to get delivered <wink>.
-
- Please note that the web u/i does /not/ work yet.
-
-
-
-Local Variables:
-mode: indented-text
-indent-tabs-mode: nil
-End: