After a current analysis by Richard Wackerbarth, it was found that not

including site-packages in the built-out environment is what was causing
FreeBSD to fail to find the _sqlite module.  As it turns out, the reason for
adding this no longer appears relevant on Ubuntu, so just remove the setting.

Fix a reference error in bin/runner.py

Rename:
 * START.txt -> START.rst
 * README.txt -> README.rst

2 files changed, 18 insertions, 6 deletions

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`_