@@ -51,11 +51,11 @@ Initialize a Repo object
 The first step is to create a ``Repo`` object to represent your repository.
 
 	>>> from git_python import *
-	>>> repo = Repo.new("/Users/mtrier/Development/git-python")
+	>>> repo = Repo("/Users/mtrier/Development/git-python")
 
-In the above example, the directory ``/Users/mtrier/Development/git-python`` is my working
-repo and contains the ``.git`` directory. You can also initialize GitPython with a 
-bare repo.
+In the above example, the directory ``/Users/mtrier/Development/git-python`` 
+is my working repository and contains the ``.git`` directory. You can also 
+initialize GitPython with a bare repository.
 
 	>>> repo = Repo.init_bare("/var/git/git-python.git")
 
 
@@ -2,6 +2,10 @@
 import commit
 
 class Diff(object):
+    """
+    A Diff contains diff information between two commits.
+    """
+    
     def __init__(self, repo, a_path, b_path, a_commit, b_commit, a_mode, b_mode, new_file, deleted_file, diff):
         self.repo = repo
         self.a_path = a_path
 
@@ -5,6 +5,9 @@
 from method_missing import MethodMissingMixin
 
 class Git(MethodMissingMixin):
+    """
+    The Git class manages communication with the Git binary
+    """
     def __init__(self, git_dir):
         super(Git, self).__init__()
         self.git_dir = git_dir
@@ -16,7 +19,13 @@ def get_dir(self):
         return self.git_dir
 
     def execute(self, command):
-        print command
+        """
+        Handles executing the command on the shell and consumes and returns
+        the returned information (stdout)
+        
+        ``command``
+            The command to execute
+        """
         proc = subprocess.Popen(command, 
                                 shell=True,
                                 stdout=subprocess.PIPE,
 
@@ -233,7 +233,7 @@ def diff(self, a, b, *paths):
         ``paths``
             is an optional list of file paths on which to restrict the diff
         """
-        self.git.diff(a, b, '--', *paths)
+        return self.git.diff(a, b, '--', *paths)
 
     def commit_diff(self, commit):
         """
 
@@ -262,7 +262,7 @@ def test_alternates_setter_empty(self, os):
         self.repo.alternates = []
         assert_true(os.called)
 
-    def test_inspect(self):
+    def test_repr(self):
         assert_equal('<GitPython.Repo "%s/.git">' % os.path.abspath(GIT_REPO), repr(self.repo))
 
     @patch(Git, 'method_missing')