Elaborate a comment on the format of the table that drives the

freddrake · freddrake · commit 9d1c3b565fc5 · 1999-01-14T18:10:09.000Z
conversion.
diff --git a/Doc/tools/sgmlconv/latex2esis.py b/Doc/tools/sgmlconv/latex2esis.py
@@ -315,7 +315,11 @@ def main():
         sys.exit(2)
     convert(ifp, ofp, {
         # entries have the form:
-        # name: ([attribute names], first_is_optional, empty, isenv, nocontent)
+        # name: ([attribute names], is1stOptional, isEmpty, isEnv, nocontent)
+        # attribute names can be:
+        #   "string" -- normal attribute
+        #   ("string",) -- sub-element with content of macro; like for \section
+        #   ["string"] -- sub-element
         "appendix": ([], 0, 1, 0, 0),
         "bifuncindex": (["name"], 0, 1, 0, 0),
         "catcode": ([], 0, 1, 0, 0),
