From df3319328d98bb86e19de90b7f1849c293138bea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=89ric=20Lemoine?= <eric.lemoine@gmail.com>
Date: Thu, 10 Apr 2014 17:58:35 +0200
Subject: [PATCH] Add a comment to build.py

---
 build.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/build.py b/build.py
index de06719581..21f5e58485 100755
--- a/build.py
+++ b/build.py
@@ -293,6 +293,11 @@ def build_examples_all_js(t):
 @rule(r'\Abuild/examples/(?P<id>.*).json\Z')
 def examples_star_json(name, match):
     def action(t):
+        # It would make more sense to use olx.js as an input file here. We use
+        # it as an externs file instead to prevent "Cannot read property '*' of
+        # undefined" error when running examples in "raw" or "whitespace" mode.
+        # Note that we use the proper way in buildcfg/examples-all.json, which
+        # is only used to check the examples code using the compiler.
         content = json.dumps({
             'id': match.group('id'),
             'inherits': '../../buildcfg/base.json',