Added versionadded Sphinx directives where possible.

JNRowe · JNRowe · commit fa0380e06cde · 2011-04-28T19:23:03.000+01:00
Some functions have received enough churn that it is too much work to track down
their initial supported version unfortunately.
diff --git a/github2/client.py b/github2/client.py
@@ -13,6 +13,11 @@ def __init__(self, username=None, api_token=None, debug=False,
         An interface to GitHub's API:
             http://develop.github.com/
 
+        .. versionadded:: 0.2.0
+           The ``requests_per_second`` parameter
+        .. versionadded:: 0.3.0
+           The ``cache`` and ``access_token`` parameters
+
         :param str username: your own GitHub username.
         :param str api_token: can be found at https://github.com/account
             (while logged in as that user):
@@ -47,6 +52,8 @@ def project_for_user_repo(self, user, repo):
     def get_all_blobs(self, project, tree_sha):
         """Get a list of all blobs for a specific tree
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         :param str tree_sha: object ID of tree
         """
diff --git a/github2/issues.py b/github2/issues.py
@@ -40,6 +40,8 @@ class Issues(GithubCommand):
     def search(self, project, term, state="open"):
         """Get all issues for project that match term with given state.
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         :param str term: term to search issues for
         :param str state: can be either ``open`` or ``closed``.
@@ -60,6 +62,8 @@ def list(self, project, state="open"):
     def list_by_label(self, project, label):
         """Get all issues for project with label.
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         :param str label:  a string representing a label (e.g., ``bug``).
         """
@@ -69,6 +73,8 @@ def list_by_label(self, project, label):
     def list_labels(self, project):
         """Get all labels for project.
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         """
         return self.get_values("labels", project, filter="labels")
@@ -105,6 +111,8 @@ def close(self, project, number):
     def reopen(self, project, number):
         """Reopen a closed issue
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         :param int number: issue number in the Github database
         """
@@ -114,6 +122,8 @@ def reopen(self, project, number):
     def edit(self, project, number, title, body):
         """Edit an existing issue
 
+        .. versionadded:: 0.3.0
+
         :param str project: GitHub project
         :param int number: issue number in the Github database
         :param str title: title for issue
diff --git a/github2/repositories.py b/github2/repositories.py
@@ -44,8 +44,12 @@ def show(self, project):
         """
         return self.get_value("show", project, filter="repository",
                               datatype=Repository)
+
     def pushable(self):
-        """Return a list of repos you can push to that are not your own."""
+        """Return a list of repos you can push to that are not your own.
+
+        .. versionadded:: 0.3.0
+        """
         return self.get_values("pushable", filter="repositories", datatype=Repository)
 
 
