Split generate_settings in src2asciidoc.

scripts/dev/src2asciidoc.py

@@ -347,18 +347,8 @@ def generate_commands(filename):
             f.write(_get_command_doc(name, cmd))
 
 
-def generate_settings(filename):
-    """Generate the complete settings section."""
-    with _open_file(filename) as f:
-        f.write("= Settings\n")
-        f.write(_get_setting_quickref() + "\n")
-        for sectname, sect in configdata.DATA.items():
-            f.write("\n")
-            f.write("== {}".format(sectname) + "\n")
-            f.write(configdata.SECTION_DESC[sectname] + "\n")
-            if not getattr(sect, 'descriptions'):
-                pass
-            else:
+def _generate_setting_section(f, sectname, sect):
+    """Generate documentation for a single section."""
     for optname, option in sect.items():
         f.write("\n")
         f.write('[[{}-{}]]'.format(sectname, optname) + "\n")
@@ -383,6 +373,21 @@ def generate_settings(filename):
             f.write("Default: empty\n")
 
 
+def generate_settings(filename):
+    """Generate the complete settings section."""
+    with _open_file(filename) as f:
+        f.write("= Settings\n")
+        f.write(_get_setting_quickref() + "\n")
+        for sectname, sect in configdata.DATA.items():
+            f.write("\n")
+            f.write("== {}".format(sectname) + "\n")
+            f.write(configdata.SECTION_DESC[sectname] + "\n")
+            if not getattr(sect, 'descriptions'):
+                pass
+            else:
+                _generate_setting_section(f, sectname, sect)
+
+
 def _get_authors():
     """Get a list of authors based on git commit logs."""
     corrections = {