Adjusting docstrings a bit to my taste.

diff --git a/mediagoblin/util.py b/mediagoblin/util.py
index b05aad1d616a309b193d9b7b1b0170dabded9a40..67847de66e32a70ec543f380d06b1b00a8ac5f33 100644 (file)
--- a/mediagoblin/util.py
+++ b/mediagoblin/util.py
@@ -306,10 +306,12 @@ class Pagination(object):
 
     def __init__(self, page, cursor, per_page=2):
         """
-        initializes Pagination
-        -- page,       requested page
-        -- per_page,   number of objects per page
-        -- cursor,     db cursor 
+        Initializes Pagination
+
+        Args:
+         - page: requested page
+         - per_page: number of objects per page
+         - cursor: db cursor 
         """
         self.page = page    
         self.per_page = per_page
@@ -318,7 +320,7 @@ class Pagination(object):
 
     def __call__(self):
         """
-        returns slice of objects for the requested page
+        Returns slice of objects for the requested page
         """
         return self.cursor.skip((self.page-1)*self.per_page) \
                           .limit(self.per_page)