commit 975b749b5c66b452b15ebf9e761d85bea06dd42d
author Keir Mierle <keir@google.com> Thu Mar 19 12:44:04 2020 -0700
committer CQ Bot Account <commit-bot@chromium.org> Thu Mar 19 20:37:33 2020 +0000
tree 7fafdd53702a9e33f6e8e6388274b453e58f32f2
parent 064da0b8e1bb40f9a49c409e23c0d3448f1e493a

pw_docgen: Disable banner due to unicode (Windows)

This disables printing the banner in docgen, since it is currently
breaking the Windows doc build. Eventually this should get re-enabled
once the root issue is addressed.

Bug: pwbug/164
Change-Id: I9cf17edd2f5f83b3da99fc2319fa23fdeea3a45b

pw_docgen/py/docgen.py

diff --git a/pw_docgen/py/docgen.py b/pw_docgen/py/docgen.py
index eed19ec..adf2c75 100644
--- a/pw_docgen/py/docgen.py
+++ b/pw_docgen/py/docgen.py
@@ -130,7 +130,9 @@
     if os.path.exists(args.sphinx_build_dir):
         shutil.rmtree(args.sphinx_build_dir)
 
-    print(SCRIPT_HEADER)
+    # TODO(pwbug/164): Printing the header causes unicode problems on Windows.
+    # Disabled for now; re-enable once the root issue is fixed.
+    #print(SCRIPT_HEADER)
     copy_doc_tree(args)
 
     # Flush all script output before running Sphinx.