aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJean-Baptiste Queru <jbq@google.com>2012-04-19 15:59:39 -0700
committerJean-Baptiste Queru <jbq@google.com>2012-04-20 07:06:47 -0700
commit50fc5ad682bbaf94237047de235c8774e0feef98 (patch)
tree5c3ecb94015aa4c33d9c360766bfc9ffafd5fc01
parent51489a6148c10b4fbfbb9590d2cd5bbb24e3f371 (diff)
downloadsource.android.com-50fc5ad682bbaf94237047de235c8774e0feef98.tar.gz
Document build issues related to uncommon tool behaviors
Change-Id: I47b04b9685cee6d2d639a3722c2d708f3bf8596d
-rw-r--r--src/source/known-issues.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/src/source/known-issues.md b/src/source/known-issues.md
index 1643055b..1fad5606 100644
--- a/src/source/known-issues.md
+++ b/src/source/known-issues.md
@@ -123,3 +123,18 @@ compiler to not be a host compiler.
**Fix**: Use a "clean" shell, in which no previous
actions could have swapped the default compiler.
+
+## Build errors caused by non-default tool settings. ##
+
+**Symptom**: The build fails with various symptoms, possibly
+complinaing about missing files or files that have the
+wrong format. One such symptom is `member [...] in archive is not an object`.
+
+**Cause**: The Android build system tends to use many host tools
+and to rely on their default behaviors. Some settings change
+those tools' behaviors and make them behave in ways that
+confuse the build system. Variables known to cause such
+issues are `CDPATH` and `GREP_OPTIONS`.
+
+**Fix**: Build Android in an environment that has as few
+customizations as possible.