[2157] add some notes to generate_docfile

diff --git a/src/bin/auth/gen-statisticsitems.py.pre.in b/src/bin/auth/gen-statisticsitems.py.pre.in
index d50804711e631809dd2a0e928157552ab2e088e5..43f81fdc0e761adf88ab4e7586e712b11c7100d3 100755 (executable)
--- a/src/bin/auth/gen-statisticsitems.py.pre.in
+++ b/src/bin/auth/gen-statisticsitems.py.pre.in
@@ -219,6 +219,7 @@ 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
                         command.tail = ''
                         prev = command
                     else:
@@ -226,6 +227,7 @@ def generate_docfile(docfile, def_mtime):
                             sim_para.text += word + ' '
                         else:
                             prev.tail += word + ' '
+                # remove extra trailing whitespaces
                 sim_para.text = sim_para.text.rstrip()
                 if prev is not None:
                     prev.tail = prev.tail.rstrip()