removed sphinx warnings

docs/_themes/README.md

@@ -6,14 +6,14 @@ his projects. It is a derivative of Mitsuhiko's themes for Flask and Flask relat
 projects.  To use this style in your Sphinx documentation, follow
 this guide:
 
-1. put this folder as _themes into your docs folder.  Alternatively
+1. put this folder as _themes into your docs folder. Alternatively
    you can also use git submodules to check out the contents there.
 
-2. add this to your conf.py: ::
+2. add this to your conf.py:
 
     sys.path.append(os.path.abspath('_themes'))
     html_theme_path = ['_themes']
-    html_theme = 'flask'
+    html_theme = 'kr'
 
 The following themes exist:
 

docs/api.rst

@@ -8,12 +8,13 @@ Database
 --------
 
 .. autoclass:: dataset.Database
-   :members: get_table, create_table, load_table, query
-   :undoc-members:
+   :members: get_table, create_table, load_table, query, tables
+   :special-members:
+
 
 Table
 -----
 
 .. autoclass:: dataset.Table
-   :members:
-   :undoc-members:
+   :members: columns, drop, insert, update, upsert, find, find_one, distinct, create_column, create_index, all
+   :special-members:

docs/quickstart.rst

@@ -74,9 +74,9 @@ Running custom SQL queries
 
 Of course the main reason you're using a database is that you want to use the full power of SQL queries. Here's how you run them using dataset::
 
-   result = db.query('SELECT country, COUNT(*) cnt FROM population GROUP BY year')
-   for row in res:
-      print row.country, row.cnt
+   result = db.query('SELECT user, COUNT(*) c FROM photos GROUP BY user ORDER BY c DESC')
+   for row in result:
+      print row['user'], row['c']
 
 Freezing your data
 ------------------