Add API docs

API doc sources are generated by "make apidocs". The modules.rst
file is then pulled into index.rst.

docs/Makefile

@@ -151,3 +151,8 @@ doctest:
 	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
 	@echo "Testing of doctests in the sources finished, look at the " \
 	      "results in $(BUILDDIR)/doctest/output.txt."
+
+apidocs:
+	sphinx-apidoc -f -o . ../src/fiona
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

docs/conf.py

@@ -11,6 +11,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import fiona
 import sys, os
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -48,9 +49,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '0.10'
+version = fiona.__version__
 # The full version, including alpha/beta/rc tags.
-release = '0.10'
+release = fiona.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/index.rst

@@ -1,18 +1,12 @@
-.. Fiona documentation master file, created by
-   sphinx-quickstart on Mon Dec 26 12:16:26 2011.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to Fiona's documentation!
-=================================
-
-Contents:
+Fiona Documentation Contents
+============================
 
 .. toctree::
    :maxdepth: 2
 
    README
-   manual
+   User Manual <manual>
+   API Documentation <modules>
 
 
 Indices and tables

docs/manual.rst

@@ -3,7 +3,8 @@ The Fiona User Manual
 =====================
 
 :Author: Sean Gillies, <sean.gillies@gmail.com>
-:Date: 23 March 2013
+:Version: |release|
+:Date: |today|
 :Copyright: 
   This work is licensed under a `Creative Commons Attribution 3.0
   United States License`__.