diff --git a/Usage.txt b/Usage.txt
index 004210b478..558329bdac 100644
--- a/Usage.txt
+++ b/Usage.txt
@@ -29,7 +29,7 @@ Ways to specify what to build:
An alternative to setting $TARGET_PRODUCT and $TARGET_BUILD_VARIANT,
which you may see in build servers, is to execute:
- make PRODUCT--
+ m PRODUCT--
A target may be a file path. For example, out/host/linux-x86/bin/adb .
@@ -46,6 +46,17 @@ Ways to specify what to build:
files named Android.bp
these files are defined in Blueprint syntax
+ During a build, a few log files are generated in ${OUT} (or ${DIST_DIR}/logs
+ for dist builds):
+
+ verbose.log.gz
+ every command run, along with its outputs. This is similar to the
+ previous `m showcommands` option.
+ error.log
+ list of actions that failed during the build, and their outputs.
+ soong.log
+ verbose debug information from soong_ui
+
For now, the full (extremely large) compiled list of targets can be found
(after running the build once), split among these two files:
@@ -57,8 +68,6 @@ Ways to specify what to build:
tool here.
Targets that adjust an existing build:
- showcommands Display the individual commands run to implement
- the build
dist Copy into ${DIST_DIR} the portion of the build
that must be distributed
@@ -71,7 +80,7 @@ Variables
Variables can either be set in the surrounding shell environment or can be
passed as command-line arguments. For example:
export I_AM_A_SHELL_VAR=1
- I_AM_ANOTHER_SHELL_VAR=2 make droid I_AM_A_MAKE_VAR=3
+ I_AM_ANOTHER_SHELL_VAR=2 m droid I_AM_A_MAKE_VAR=3
Here are some common variables and their meanings:
TARGET_PRODUCT The to build # as described above
TARGET_BUILD_VARIANT The to build # as described above
diff --git a/core/build-system.html b/core/build-system.html
index 3d86e24a9b..3a11a477dc 100644
--- a/core/build-system.html
+++ b/core/build-system.html
@@ -147,12 +147,6 @@ Dependecies
.c, .cpp, .h, .java, java libraries, etc., should all work without intervention
in the Android.mk file.
-Hiding command lines
-The default of the build system will be to hide the command lines being
-executed for make steps. It will be possible to override this by specifying
-the showcommands pseudo-target, and possibly by setting an environment
-variable.
-
Wildcard source files
Wildcarding source file will be discouraged. It may be useful in some
scenarios. The default $(wildcard *)
will not work due to the
@@ -326,19 +320,6 @@
More pseudotargets
directory inside the current combo directory. This is especially useful on the
simulator and emulator, where the persistent data remains present between
builds.
-showcommands - showcommands
is a modifier target
-which causes the build system to show the actual command lines for the build
-steps, instead of the brief descriptions. Most people don't like seeing the
-actual commands, because they're quite long and hard to read, but if you need
-to for debugging purposes, you can add showcommands
to the list
-of targets you build. For example make showcommands
will build
-the default android configuration, and make runtime showcommands
-will build just the runtime, and targets that it depends on, while displaying
-the full command lines. Please note that there are a couple places where the
-commands aren't shown here. These are considered bugs, and should be fixed,
-but they're often hard to track down. Please let
-android-build-team know if you find
-any.
LOCAL_MODULE - Anything you specify as a LOCAL_MODULE
in an Android.mk is made into a pseudotarget. For example, make
runtime
might be shorthand for make