Inline references. Remove unneeded anchors

Author: AA-Turner

pep_sphinx_extensions/pep_zero_generator/writer.py

@@ -49,16 +49,12 @@
 
 intro = """\
 This PEP contains the index of all Python Enhancement Proposals,
-known as PEPs.  PEP numbers are assigned by the PEP editors, and
-once assigned are never changed [1_].  The version control history [2_] of
+known as PEPs.  PEP numbers are :pep:`assigned <1#pep-editors>`
+by the PEP editors, and once assigned are never changed.  The
+`version control history <https://github.com/python/peps>`_ of
 the PEP texts represent their historical record.
 """
 
-references = """\
-.. [1] PEP 1: PEP Purpose and Guidelines
-.. [2] View PEP history online: https://github.com/python/peps
-"""
-
 
 class PEPZeroWriter:
     # This is a list of reserved PEP numbers.  Reservations are not to be used for
@@ -100,17 +96,16 @@ def emit_column_headers(self) -> None:
         self.emit_pep_row({"status": ".", "type": ".", "number": "PEP", "title": "PEP Title", "authors": "PEP Author(s)"})
         self.emit_table_separator()
 
-    def emit_title(self, text: str, anchor: str, *, symbol: str = "=") -> None:
-        self.output.append(f".. _{anchor}:\n")
+    def emit_title(self, text: str, *, symbol: str = "=") -> None:
         self.output.append(text)
         self.output.append(symbol * len(text))
         self.emit_newline()
 
-    def emit_subtitle(self, text: str, anchor: str) -> None:
-        self.emit_title(text, anchor, symbol="-")
+    def emit_subtitle(self, text: str) -> None:
+        self.emit_title(text, symbol="-")
 
-    def emit_pep_category(self, category: str, anchor: str, peps: list[PEP]) -> None:
-        self.emit_subtitle(category, anchor)
+    def emit_pep_category(self, category: str, peps: list[PEP]) -> None:
+        self.emit_subtitle(category)
         self.emit_column_headers()
         for pep in peps:
             self.output.append(column_format(**pep.details(title_length=title_length)))
@@ -124,44 +119,40 @@ def write_pep0(self, peps: list[PEP]):
         self.emit_newline()
 
         # Introduction
-        self.emit_title("Introduction", "intro")
+        self.emit_title("Introduction")
         self.emit_text(intro)
         self.emit_newline()
 
         # PEPs by category
-        self.emit_title("Index by Category", "by-category")
+        self.emit_title("Index by Category")
         meta, info, provisional, accepted, open_, finished, historical, deferred, dead = _classify_peps(peps)
         pep_categories = [
-            ("Meta-PEPs (PEPs about PEPs or Processes)", "by-category-meta", meta),
-            ("Other Informational PEPs", "by-category-other-info", info),
-            ("Provisional PEPs (provisionally accepted; interface may still change)", "by-category-provisional", provisional),
-            ("Accepted PEPs (accepted; may not be implemented yet)", "by-category-accepted", accepted),
-            ("Open PEPs (under consideration)", "by-category-open", open_),
-            ("Finished PEPs (done, with a stable interface)", "by-category-finished", finished),
-            ("Historical Meta-PEPs and Informational PEPs", "by-category-historical", historical),
-            ("Deferred PEPs (postponed pending further research or updates)", "by-category-deferred", deferred),
-            ("Abandoned, Withdrawn, and Rejected PEPs", "by-category-abandoned", dead),
+            ("Meta-PEPs (PEPs about PEPs or Processes)", meta),
+            ("Other Informational PEPs", info),
+            ("Provisional PEPs (provisionally accepted; interface may still change)", provisional),
+            ("Accepted PEPs (accepted; may not be implemented yet)", accepted),
+            ("Open PEPs (under consideration)", open_),
+            ("Finished PEPs (done, with a stable interface)", finished),
+            ("Historical Meta-PEPs and Informational PEPs", historical),
+            ("Deferred PEPs (postponed pending further research or updates)", deferred),
+            ("Abandoned, Withdrawn, and Rejected PEPs", dead),
         ]
-        for (category, anchor, peps_in_category) in pep_categories:
-            self.emit_pep_category(category, anchor, peps_in_category)
+        for (category, peps_in_category) in pep_categories:
+            self.emit_pep_category(category, peps_in_category)
 
         self.emit_newline()
 
         # PEPs by number
-        self.emit_title("Numerical Index", "by-pep-number")
+        self.emit_title("Numerical Index")
         self.emit_column_headers()
-        prev_pep = 0
         for pep in peps:
-            if pep.number - prev_pep > 1:
-                self.emit_newline()
             self.emit_pep_row(pep.details(title_length=title_length))
-            prev_pep = pep.number
 
         self.emit_table_separator()
         self.emit_newline()
 
         # Reserved PEP numbers
-        self.emit_title("Reserved PEP Numbers", "reserved")
+        self.emit_title("Reserved PEP Numbers")
         self.emit_column_headers()
         for number, claimants in sorted(self.RESERVED.items()):
             self.emit_pep_row({"type": ".", "status": ".", "number": number, "title": "RESERVED", "authors": claimants})
@@ -170,15 +161,15 @@ def write_pep0(self, peps: list[PEP]):
         self.emit_newline()
 
         # PEP types key
-        self.emit_title("PEP Types Key", "type-key")
+        self.emit_title("PEP Types Key")
         for type_ in sorted(TYPE_VALUES):
             self.emit_text(f"    {type_[0]} - {type_} PEP")
             self.emit_newline()
 
         self.emit_newline()
 
         # PEP status key
-        self.emit_title("PEP Status Key", "status-key")
+        self.emit_title("PEP Status Key")
         for status in sorted(STATUS_VALUES):
             # Draft PEPs have no status displayed, Active shares a key with Accepted
             if status in HIDE_STATUS:
@@ -195,7 +186,7 @@ def write_pep0(self, peps: list[PEP]):
         # PEP owners
         authors_dict = _verify_email_addresses(peps)
         max_name_len = max(len(author_name) for author_name in authors_dict)
-        self.emit_title("Authors/Owners", "authors")
+        self.emit_title("Authors/Owners")
         self.emit_author_table_separator(max_name_len)
         self.emit_text(f"{'Name':{max_name_len}}  Email Address")
         self.emit_author_table_separator(max_name_len)
@@ -207,10 +198,6 @@ def write_pep0(self, peps: list[PEP]):
         self.emit_newline()
         self.emit_newline()
 
-        # References for introduction footnotes
-        self.emit_title("References", "references")
-        self.emit_text(references)
-
         pep0_string = "\n".join([str(s) for s in self.output])
         return pep0_string