Fix cross-module Sphinx references

bgilbert · bgilbert · commit f4dd7d36fb28 · 2014-05-02T03:24:03.000-04:00
diff --git a/github3/gists/gist.py b/github3/gists/gist.py
@@ -83,7 +83,8 @@ def __init__(self, data, session=None):
         #: Number of files in this gist.
         self.files = len(self._files)
 
-        #: History of this gist, list of :class:`GistHistory <GistHistory>`
+        #: History of this gist, list of
+        #: :class:`GistHistory <github3.gists.history.GistHistory>`
         self.history = [GistHistory(h, self) for h in data.get('history', [])]
 
         ## New urls
diff --git a/github3/issues/issue.py b/github3/issues/issue.py
@@ -62,12 +62,14 @@ def __init__(self, issue, session=None):
         self.html_url = issue.get('html_url')
         #: Unique ID for the issue.
         self.id = issue.get('id')
-        #: Returns the list of :class:`Label <Label>`\ s on this issue.
+        #: Returns the list of :class:`Label <github3.issues.label.Label>`\ s
+        #: on this issue.
         self.labels = [Label(l, self._session) for l in issue.get('labels')]
         labels_url = issue.get('labels_url')
         #: Labels URL Template. Expand with ``name``
         self.labels_urlt = URITemplate(labels_url) if labels_url else None
-        #: :class:`Milestone <Milestone>` this issue was assigned to.
+        #: :class:`Milestone <github3.issues.milestone.Milestone>` this
+        #: issue was assigned to.
         self.milestone = None
         if issue.get('milestone'):
             self.milestone = Milestone(issue.get('milestone'), self._session)
@@ -145,7 +147,7 @@ def comment(self, id_num):
         sigmavirus24/Todo.txt-python, the first comment's id is 4150787.
 
         :param int id_num: (required), comment id, see example above
-        :returns: :class:`IssueComment <IssueComment>`
+        :returns: :class:`IssueComment <github3.issues.comment.IssueComment>`
         """
         json = None
         if int(id_num) > 0:  # Might as well check that it's positive
@@ -160,7 +162,7 @@ def create_comment(self, body):
         """Create a comment on this issue.
 
         :param str body: (required), comment body
-        :returns: :class:`IssueComment <IssueComment>`
+        :returns: :class:`IssueComment <github3.issues.comment.IssueComment>`
         """
         json = None
         if body:
@@ -213,7 +215,8 @@ def iter_comments(self, number=-1):
         """Iterate over the comments on this issue.
 
         :param int number: (optional), number of comments to iterate over
-        :returns: iterator of :class:`IssueComment <IssueComment>`
+        :returns: iterator of
+            :class:`IssueComment <github3.issues.comment.IssueComment>`\ s
         """
         url = self._build_url('comments', base_url=self._api)
         return self._iter(int(number), url, IssueComment)
@@ -223,7 +226,8 @@ def iter_events(self, number=-1):
 
         :param int number: (optional), number of events to return. Default: -1
             returns all events available.
-        :returns: generator of :class:`IssueEvent <IssueEvent>`\ s
+        :returns: generator of
+            :class:`IssueEvent <github3.issues.event.IssueEvent>`\ s
         """
         url = self._build_url('events', base_url=self._api)
         return self._iter(int(number), url, IssueEvent)
@@ -235,6 +239,7 @@ def iter_labels(self, number=-1, etag=None):
             returns all labels applied to this issue.
         :param str etag: (optional), ETag from a previous request to the same
             endpoint
+        :returns: generator of :class:`Label <github3.issues.label.Label>`\ s
         """
         url = self._build_url('labels', base_url=self._api)
         return self._iter(int(number), url, Label, etag=etag)
diff --git a/github3/issues/milestone.py b/github3/issues/milestone.py
@@ -68,7 +68,7 @@ def iter_labels(self, number=-1, etag=None):
         :param int number: (optional), number of labels to return. Default: -1
             returns all available labels.
         :param str etag: (optional), ETag header from a previous response
-        :returns: generator of :class:`Label <Label>`\ s
+        :returns: generator of :class:`Label <github3.issues.label.Label>`\ s
         """
         url = self._build_url('labels', base_url=self._api)
         return self._iter(int(number), url, Label, etag=etag)
diff --git a/github3/notifications.py b/github3/notifications.py
@@ -86,7 +86,7 @@ def set_subscription(self, subscribed, ignored):
             be received from this thread.
         :param bool ignored: (required), determines if notifications should be
             ignored from this thread.
-        :returns: :class;`Subscription <Subscription>`
+        :returns: :class:`Subscription <Subscription>`
         """
         url = self._build_url('subscription', base_url=self._api)
         sub = {'subscribed': subscribed, 'ignored': ignored}
diff --git a/github3/repos/branch.py b/github3/repos/branch.py
@@ -14,8 +14,8 @@ def __init__(self, branch, session=None):
         super(Branch, self).__init__(branch, session)
         #: Name of the branch.
         self.name = branch.get('name')
-        #: Returns the branch's :class:`RepoCommit <RepoCommit>` or
-        #: ``None``.
+        #: Returns the branch's
+        #: :class:`RepoCommit <github3.repos.commit.RepoCommit>` or ``None``.
         self.commit = branch.get('commit')
         if self.commit:
             self.commit = RepoCommit(self.commit, self._session)
diff --git a/github3/repos/comparison.py b/github3/repos/comparison.py
@@ -42,8 +42,8 @@ def __init__(self, compare):
         self.diff_url = compare.get('diff_url')
         #: Patch URL at GitHub for the comparison.
         self.patch_url = compare.get('patch_url')
-        #: :class:`RepoCommit <RepoCommit>` object representing the base of
-        #: comparison.
+        #: :class:`RepoCommit <github3.repos.commit.RepoCommit>` object
+        #: representing the base of comparison.
         self.base_commit = RepoCommit(compare.get('base_commit'), None)
         #: Behind or ahead.
         self.status = compare.get('status')
@@ -53,7 +53,8 @@ def __init__(self, compare):
         self.behind_by = compare.get('behind_by')
         #: Number of commits difference in the comparison.
         self.total_commits = compare.get('total_commits')
-        #: List of :class:`RepoCommit <RepoCommit>` objects.
+        #: List of :class:`RepoCommit <github3.repos.commit.RepoCommit>`
+        #: objects.
         self.commits = [RepoCommit(com) for com in compare.get('commits')]
         #: List of dicts describing the files modified.
         self.files = compare.get('files', [])
diff --git a/github3/repos/repo.py b/github3/repos/repo.py
