docs: automate the documentation of deprecated configuration names

Author: nedbat

docs/configuration.rst

@@ -397,9 +397,20 @@ Deprecated Settings
 Some names in the config file have been updated. The old names will continue to
 work, but the new names are preferred:
 
+.. [[[cog
+    from scriv.config import DEPRECATED_NAMES
+
+    print()
+    for old, new in DEPRECATED_NAMES:
+        print(f"- ``{old}`` is now ``{new}``.")
+    print()
+.. ]]]
+
 - ``output_file`` is now ``changelog``.
 - ``insert_marker`` is now ``start_marker``.
 
+.. [[[end]]] (checksum: c0c4c703b20146d23fe0cba53a324d3b)
+
 
 .. _git_settings:
 

src/scriv/config.py

@@ -225,7 +225,7 @@ class _Options:
 
 
 # Map of old config names to new config names.
-REPLACED_NAMES = [
+DEPRECATED_NAMES = [
     ("output_file", "changelog"),
     ("insert_marker", "start_marker"),
 ]
@@ -341,7 +341,7 @@ def read_one_config(self, configfile: str) -> None:
             scriv_data = parser[section_name]
             for attrdef in attr.fields(_Options):
                 self.get_set_option(scriv_data, attrdef.name, attrdef.name)
-            for old, new in REPLACED_NAMES:
+            for old, new in DEPRECATED_NAMES:
                 self.get_set_option(scriv_data, old, new)
 
     def read_one_toml(self, tomlfile: str) -> None:
@@ -377,7 +377,7 @@ def read_one_toml(self, tomlfile: str) -> None:
                 return
             for attrdef in attr.fields(_Options):
                 self.get_set_option(scriv_data, attrdef.name, attrdef.name)
-            for old, new in REPLACED_NAMES:
+            for old, new in DEPRECATED_NAMES:
                 self.get_set_option(scriv_data, old, new)
 
     def resolve_value(self, value: str) -> str: