Autmatically get version and release from roundup/__init__.py

Copy code from docs/conf.py that generates the release and version
settings from roundup/__init__.py into website/www/conf.py.

Update RELEASE.txt to remove need to set these manually and annotate a
couple of other documented changes.

Author: rouilj

RELEASE.txt

@@ -32,8 +32,8 @@ Roundup release checklist:
 3.  Update version in:
       CHANGES.txt (set date for version as well) 
       roundup/__init__.py
-      website/www/index.txt
-      website/www/conf.py  (also update copyright)
+      website/www/index.txt (current stable version, release highlights)
+      website/www/conf.py  (update copyright, version from __init__.py)
 3a. Update license end date in COPYING.txt
 3b. Update doc/acknowledgements.txt (add section for
     release, churn contributers etc.). (Use hg churn -c -r ####..####)

doc/conf.py

@@ -23,7 +23,7 @@
 
 
 # Read Roundup version by importing it from parent directory,
-# this ensures that 'unkown version' is inserted even if
+# this ensures that 'unknown version' is inserted even if
 # `roundup` is importable from other location in sys.path
 SYSSAVE = sys.path
 DOCROOT = os.path.abspath(os.path.dirname(__file__))

website/www/conf.py

@@ -19,6 +19,20 @@
 
 import sys, os
 
+# Read Roundup version by importing it from root of checkout.
+# this ensures that 'unknown version' is inserted even if
+# `roundup` is importable from other location in sys.path
+SYSSAVE = sys.path
+DOCROOT = os.path.abspath(os.path.dirname(__file__) + "/..")
+sys.path = [os.path.dirname(DOCROOT)]
+try:
+    from roundup import __version__ as VERSION
+    SHORTVER = '.'.join(VERSION.split('.', 2)[:2])
+except ImportError:
+    VERSION = SHORTVER = '(unknown version)'
+finally:
+    sys.path = SYSSAVE
+
 # If your extensions are in another directory, add it here. If the directory
 # is relative to the documentation root, use os.path.abspath to make it
 # absolute, like shown here.
@@ -55,9 +69,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '2.3b2'
+version = SHORTVER
 # The full version, including alpha/beta/rc tags.
-release = '2.3.0b2'
+release = VERSION
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.