Cosmetic changes

src/sage_setup/autogen/__init__.py

@@ -4,16 +4,17 @@
 def autogen_all():
     """
     Regenerate the automatically generated files of the Sage library.
+
+    Return a list of sub-packages that should be appended to the list
+    of packages built/installed by setup.py.
     """
     from sage_setup.autogen import pari
     pari.rebuild()
 
     from sage_setup.autogen import interpreters
     interpreters.rebuild(os.path.join("sage", "ext", "interpreters"))
 
-    # Return list of sub-packages that should be appended to the list of
-    # packages built/installed by setup.py
-    #
-    # In the case of Pari it just adds new files to an existing package (rather
-    # than autogenerating the entire sub-package) so it's omitted here.
+    # In the case of Pari it just adds new files to an existing package
+    # (rather than autogenerating the entire sub-package) so it is
+    # omitted here.
     return ['sage.ext.interpreters']

src/setup.py

@@ -669,10 +669,11 @@ def copy_extra_files(self):
 class sage_build(build):
     def run_autogen(self):
         """
-        Generating auto-generated Sources This must be done before discovering
-        and building the python modules. See #22106.
-        """
+        Generate auto-generated sources.
 
+        This must be done before building the python modules,
+        see :trac:`22106`.
+        """
         from sage_setup.autogen import autogen_all
         log.info("Generating auto-generated sources")
         self.distribution.packages += autogen_all()