summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYifan Hong <elsk@google.com>2024-04-16 12:12:07 -0700
committerTreehugger Robot <android-test-infra-autosubmit@system.gserviceaccount.com>2024-04-23 20:52:02 +0000
commitb8f7cd89405edc4a41552f8a8250420aa60b1a16 (patch)
treeb6d6f332abe549588307ab07e4532a6b5077acc6
parent1d3078ec9fee23595a4516e7c9e2ab49f7ea03e9 (diff)
downloadbuild-b8f7cd89405edc4a41552f8a8250420aa60b1a16.tar.gz
kleaf: update docs about --debug_make_verbosity.
Describe in more detail what each flag means. This also updates bazel help kleaf. Test: bazel help kleaf Change-Id: I367464aa23328f39c6f03170ccbac816e4fcb3ee
-rw-r--r--kleaf/BUILD.bazel8
-rw-r--r--kleaf/docs/debugging.md8
2 files changed, 10 insertions, 6 deletions
diff --git a/kleaf/BUILD.bazel b/kleaf/BUILD.bazel
index cd42d0b..478808e 100644
--- a/kleaf/BUILD.bazel
+++ b/kleaf/BUILD.bazel
@@ -518,10 +518,10 @@ selects.config_setting_group(
)
# Debug flag to control make verbosity
-# E (default) = Error (-s)
-# I = Info
-# D = Debug (V=1)
-# V = Verbose (V=2)
+# E (default): Only print errors (make -s)
+# I: print brief description of make targets being built (make)
+# D: print full commands (make V=1)
+# V: print the reason for the rebuild of each make target (make V=2)
string_flag(
name = "debug_make_verbosity",
build_setting_default = "E",
diff --git a/kleaf/docs/debugging.md b/kleaf/docs/debugging.md
index 465d945..bf2bfd3 100644
--- a/kleaf/docs/debugging.md
+++ b/kleaf/docs/debugging.md
@@ -18,8 +18,12 @@ This is a non exhaustive list of options to help debugging compilation issues:
* Customise Kbuild:
- * `--debug_make_verbosity`: Controls verbosity of `make` executions `E
- (default) = Error, I = Info, D = Debug`
+ * `--debug_make_verbosity`: Controls verbosity of `make` executions.
+ * `E` (default): Only print errors (`make -s`)
+ * `I`: print brief description of make targets being built (`make`)
+ * `D`: print full commands (`make V=1`)
+ * `V`: print the reason for the rebuild of each make target
+ (`make V=2`)
* `--debug_modpost_warn`: Sets
[`KBUILD_MODPOST_WARN=1`](https://www.kernel.org/doc/html/latest/kbuild/kbuild.html#kbuild-modpost-warn).