summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.rst (renamed from README.txt)0
-rw-r--r--buildout.cfg2
-rw-r--r--src/mailman/bin/runner.py3
-rw-r--r--src/mailman/docs/START.rst (renamed from src/mailman/docs/START.txt)21
4 files changed, 18 insertions, 8 deletions
diff --git a/README.txt b/README.rst
index d0f2a7377..d0f2a7377 100644
--- a/README.txt
+++ b/README.rst
diff --git a/buildout.cfg b/buildout.cfg
index c083ade7a..2c1021332 100644
--- a/buildout.cfg
+++ b/buildout.cfg
@@ -5,8 +5,6 @@ parts =
interpreter
tags
test
-# LP: #659231
-include-site-packages = false
unzip = true
develop = .
diff --git a/src/mailman/bin/runner.py b/src/mailman/bin/runner.py
index b27ff04ea..b19904aa7 100644
--- a/src/mailman/bin/runner.py
+++ b/src/mailman/bin/runner.py
@@ -220,6 +220,8 @@ def main():
options = ScriptOptions()
options.initialize()
+ log = logging.getLogger('mailman.runner')
+
if options.options.list:
descriptions = {}
for section in config.runner_configs:
@@ -248,7 +250,6 @@ def main():
if runner.intercept_signals:
set_signals(loop)
# Now start up the main loop
- log = logging.getLogger('mailman.runner')
log.info('%s runner started.', loop.name())
runner.run()
log.info('%s runner exiting.', loop.name())
diff --git a/src/mailman/docs/START.txt b/src/mailman/docs/START.rst
index d7ef55b22..ab2717956 100644
--- a/src/mailman/docs/START.txt
+++ b/src/mailman/docs/START.rst
@@ -20,10 +20,14 @@ mailman-developers@python.org 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 works just fine with Python 2.7,
-but Python 3 is not yet supported.
+Python 2.6 or 2.7 is required. It can either be the default 'python' on your
+$PATH or it can be accessible via the ``python2.6`` or ``python2.7`` binary.
+If your operating system does not include Python, see http://www.python.org
+downloading and installing it from source. Python 3 is not yet supported.
+
+
+Building Mailman 3
+==================
Mailman 3 is now based on the `zc.buildout`_ infrastructure, which greatly
simplifies building and testing Mailman.
@@ -35,6 +39,9 @@ everything::
% python bootstrap.py
% bin/buildout
+Sit back and have some Kombucha while you wait for everything to download and
+install.
+
Now you can run the test suite via::
% bin/test -vv
@@ -45,7 +52,7 @@ Build the online docs by running::
% bin/docs
-(You will get warnings which you can safely ignore.) Then visit
+(You might get warnings which you can safely ignore.) Then visit
parts/docs/mailman/build/mailman/docs/README.html
@@ -54,6 +61,10 @@ 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.
+
+Running Mailman 3
+=================
+
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. Mailman is configured via the `lazr.config`_