doc-only: explain why we use a while construct here

git-svn-id: https://svn.erp5.org/repos/public/erp5/trunk@29611 20353a03-c40f-0410-a6d1-a30d3c3de9de

product/ERP5/Tool/TemplateTool.py

@@ -459,6 +459,10 @@ class TemplateTool (BaseTool):
                                  stdout=subprocess.PIPE,
                                  stderr=subprocess.STDOUT)
 
+      # "for line in process.stdout" is cleaner but is buffered,
+      # see http://bugs.python.org/issue3907
+      # We use this ugly construct to avoid waiting for test
+      # termination before printing content
       while True:
         line = process.stdout.readline()
         if not line: