prepare sphinx documentation building

* docs/conf.py:
  - add sphinx.ext.viewcode to extensions
  - update copyright years
  - bump version numbers
  - explicitly define language
* setup.cfg
  - define output directory and add all_files directive

docs/conf.py

@@ -26,7 +26,7 @@ import sys, os
 
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['.templates']
@@ -42,20 +42,20 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'Debian Developer Portfolio Service'
-copyright = u'2009, Jan Dittberner'
+copyright = u'2009-2013, Jan Dittberner'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '0.1'
+version = '0.2.18'
 # The full version, including alpha/beta/rc tags.
-release = '0.1dev'
+release = '0.2.18dev'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
-#language = None
+language = 'en'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:

setup.cfg

@@ -7,6 +7,8 @@ find_links = http://www.pylonshq.com/download/
 
 [build_sphinx]
 source-dir = docs
+build-dir = docs/html
+all_files = 1
 
 [publish]
 doc-dir=docs/html