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

conversion.

diff --git a/Doc/tools/sgmlconv/latex2esis.py b/Doc/tools/sgmlconv/latex2esis.py
index 4369c5f312cc617120b4d30f75689972ba02caf4..f54e0fcee581dcb173bdf07fc51fdf29d3919f76 100755 (executable)
--- 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),