aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/versions
diff options
context:
space:
mode:
authorGravatar Googler <noreply@google.com>2016-09-08 17:23:43 +0000
committerGravatar Damien Martin-Guillerez <dmarting@google.com>2016-09-09 09:03:04 +0000
commit0fe6f8e6016bfaa93261bb96cf2987f25ee4e790 (patch)
treec487a15ad695f637d8986d23a961ce14cf52c45b /site/versions
parent934d42dc93442063a3e42be09e2aa4f5eb54409a (diff)
Suggest including a debugging=False parameter that controlled debug logging as an alternative to removing the debug logging.
-- MOS_MIGRATED_REVID=132570566
Diffstat (limited to 'site/versions')
-rw-r--r--site/versions/master/docs/skylark/macros.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/site/versions/master/docs/skylark/macros.md b/site/versions/master/docs/skylark/macros.md
index 6242af8d1a..467c818550 100644
--- a/site/versions/master/docs/skylark/macros.md
+++ b/site/versions/master/docs/skylark/macros.md
@@ -35,12 +35,13 @@ macro), use the constant [PACKAGE_NAME](lib/globals.html#PACKAGE_NAME).
## Debugging
-* `bazel query --output=build //my/path:all` will show you how the BUILD
-file looks like after evaluation. All macros, globs, loops are expanded.
+* `bazel query --output=build //my/path:all` will show you how the BUILD file
+ looks like after evaluation. All macros, globs, loops are expanded.
-* You can also use [print](lib/globals.html#print) for debugging. It displays
-the message as a warning during the loading phase. Except in rare cases, remove
-your `print` calls before submitting the code to the depot.
+* You can also use [print](lib/globals.html#print) for debugging. It displays
+ the message as a warning during the loading phase. Except in rare cases,
+ either remove `print` calls, or make them conditional under a `debugging`
+ parameter that defaults to `False` before submitting the code to the depot.
## Errors