[2157] added a note to explain why empty string is required

diff --git a/src/bin/auth/gen-statisticsitems.py.pre.in b/src/bin/auth/gen-statisticsitems.py.pre.in
index 43f81fdc0e761adf88ab4e7586e712b11c7100d3..40f33f0fbe03ba8f814f3f9c3f610c35d0d674f8 100755 (executable)
--- a/src/bin/auth/gen-statisticsitems.py.pre.in
+++ b/src/bin/auth/gen-statisticsitems.py.pre.in
@@ -219,7 +219,9 @@ def generate_docfile(docfile, def_mtime):
                     if word == xmldocument_command_name:
                         command = ElementTree.SubElement(sim_para, 'command')
                         command.text = word
-                        # append empty string for trailing text
+                        # at this point command.tail is None
+                        # append empty string as trailing text for the next
+                        # word so it can be concatinated with trailing words
                         command.tail = ''
                         prev = command
                     else: