Documentation is now being built for all new modules

8 files changed, 56 insertions, 12 deletions

diff --git a/doc/source/changes.rst b/doc/source/changes.rst
index 563fb46b..de872e2d 100644
--- a/doc/source/changes.rst
+++ b/doc/source/changes.rst
@@ -2,6 +2,10 @@
 Changelog
 =========
 
+0.3.2 Beta 2
+============
+* Added reflog support ( reading and writing )
+
 0.3.2 Beta 1
 ============
 * Flattened directory structure to make development more convenient.
diff --git a/doc/source/conf.py b/doc/source/conf.py
index e80bd0aa..469ab3b3 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -20,7 +20,7 @@ import sys, os
 # is relative to the documentation root, use os.path.abspath to make it
 # absolute, like shown here.
 #sys.path.append(os.path.abspath('.'))
-sys.path.insert(0, os.path.abspath('../../lib'))
+sys.path.insert(0, os.path.abspath('../../../'))
 
 # General configuration
 # ---------------------
diff --git a/doc/source/reference.rst b/doc/source/reference.rst
index 75e712a8..7adc5328 100644
--- a/doc/source/reference.rst
+++ b/doc/source/reference.rst
@@ -131,13 +131,48 @@ Exceptions
    :undoc-members:
 
  
-Refs
-----
+Refs.symbolic
+-------------
+
+.. automodule:: git.refs.symbolic
+   :members:
+   :undoc-members:
+   
+Refs.reference
+--------------
 
-.. automodule:: git.refs
+.. automodule:: git.refs.reference
    :members:
    :undoc-members:
 
+Refs.head
+---------
+
+.. automodule:: git.refs.head
+   :members:
+   :undoc-members:
+   
+Refs.tag
+------------
+
+.. automodule:: git.refs.tag
+   :members:
+   :undoc-members:
+   
+Refs.remote
+------------
+
+.. automodule:: git.refs.remote
+   :members:
+   :undoc-members:
+   
+Refs.log
+------------
+
+.. automodule:: git.refs.log
+   :members:
+   :undoc-members:
+   
 Remote
 ------
 
diff --git a/doc/source/tutorial.rst b/doc/source/tutorial.rst
index 9aadae47..642136ab 100644
--- a/doc/source/tutorial.rst
+++ b/doc/source/tutorial.rst
@@ -88,6 +88,14 @@ A symbolic reference is a special case of a reference as it points to another re
     head = repo.head            # the head points to the active branch/ref
     master = head.reference     # retrieve the reference the head points to
     master.commit               # from here you use it as any other reference
+    
+Access the reflog easily::
+    
+    log = master.log()
+    log[0]                      # first (i.e. oldest) reflog entry
+    log[-1]                     # last (i.e. most recent) reflog entry
+    
+For more information on the reflog, see the ``RefLog`` type's documentation.
 
 Modifying References
 ********************
diff --git a/index/base.py b/index/base.py
index 05caa06d..a63dbb26 100644
--- a/index/base.py
+++ b/index/base.py
@@ -3,8 +3,6 @@
 #
 # This module is part of GitPython and is released under
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
-"""Module containing Index implementation, allowing to perform all kinds of index
-manipulations such as querying and merging."""
 import tempfile
 import os
 import sys
diff --git a/index/fun.py b/index/fun.py
index 87fdf1a9..9b35bf04 100644
--- a/index/fun.py
+++ b/index/fun.py
@@ -1,7 +1,6 @@
-"""
-Contains standalone functions to accompany the index implementation and make it
-more versatile
-"""
+# Contains standalone functions to accompany the index implementation and make it
+# more versatile
+# NOTE: Autodoc hates it if this is a docstring
 from stat import (
 					S_IFDIR,
 					S_IFLNK,
diff --git a/refs/head.py b/refs/head.py
index 91a1132c..278cecc7 100644
--- a/refs/head.py
+++ b/refs/head.py
@@ -1,4 +1,3 @@
-""" Module containing all ref based objects """
 from symbolic import SymbolicReference
 from reference import Reference
 
diff --git a/remote.py b/remote.py
index 3edde175..2e596ca1 100644
--- a/remote.py
+++ b/remote.py
@@ -3,7 +3,8 @@
 #
 # This module is part of GitPython and is released under
 # the BSD License: http://www.opensource.org/licenses/bsd-license.php
-"""Module implementing a remote object allowing easy access to git remotes"""
+
+# Module implementing a remote object allowing easy access to git remotes
 
 from exc import GitCommandError
 from objects import Commit