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 4369c5f..f54e0fc 100755
--- a/Doc/tools/sgmlconv/latex2esis.py
+++ b/Doc/tools/sgmlconv/latex2esis.py
@@ -315,7 +315,11 @@
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),