Commits

Takayuki Shimizukawa committed 8a5db9f

fix some grammar refs #1044. thanks @mitya57 !

Comments (0)

Files changed (1)

sphinx/environment.py

                 if isinstance(child, nodes.footnote_reference) \
                    and child.get('auto') == 1:
                     # use original 'footnote_reference' object.
-                    # this object already registered in self.document.autofootnote_refs
+                    # this object is already registered in self.document.autofootnote_refs
                     patch.children[i] = footnote_refs.pop(0)
                     # Some duplicated footnote_reference in msgstr cause
-                    # IndexError by .pop(0). That is invalid msgstr.
+                    # IndexError in .pop(0). That is invalid msgstr.
 
                 elif isinstance(child, nodes.reference):
-                    # reference use original 'refname'.
+                    # reference should use original 'refname'.
                     # * reference target ".. _Python: ..." is not translatable.
                     # * section refname is not translatable.
-                    # * inline reference "`Python <...>`_" have no 'refname'.
+                    # * inline reference "`Python <...>`_" has no 'refname'.
                     if refs and 'refname' in refs[0]:
                         refname = child['refname'] = refs.pop(0)['refname']
                         self.document.refnames.setdefault(
                                 refname, []).append(child)
-                    # if reference node count is not same before translation
-                    # that offen generate unknown link target warning.
+                    # if number of reference nodes had been changed, that
+                    # would often generate unknown link target warning.
 
             for child in patch.children: # update leaves
                 child.parent = node
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.