summaryrefslogtreecommitdiffstats
path: root/clang/docs/CommandGuide
diff options
context:
space:
mode:
authorAdrian Prantl <aprantl@apple.com>2015-12-22 22:37:22 +0000
committerAdrian Prantl <aprantl@apple.com>2015-12-22 22:37:22 +0000
commita7f56ab893f36065c83d8af87fb51bc6a554980e (patch)
tree4e31582962c2e761a78de70bad554565f7ee9bd4 /clang/docs/CommandGuide
parent54bfae8f5209fc28ac191b9e82038b0f37fd239c (diff)
downloadbcm5719-llvm-a7f56ab893f36065c83d8af87fb51bc6a554980e.tar.gz
bcm5719-llvm-a7f56ab893f36065c83d8af87fb51bc6a554980e.zip
Document that we recommend to turn off -gmodules when building a static
library for distribution to other machines on the clang man page. llvm-svn: 256287
Diffstat (limited to 'clang/docs/CommandGuide')
-rw-r--r--clang/docs/CommandGuide/clang.rst7
1 files changed, 6 insertions, 1 deletions
diff --git a/clang/docs/CommandGuide/clang.rst b/clang/docs/CommandGuide/clang.rst
index 9f6d6f588e5..2b4569592a9 100644
--- a/clang/docs/CommandGuide/clang.rst
+++ b/clang/docs/CommandGuide/clang.rst
@@ -262,7 +262,12 @@ Code Generation Options
Generate debug information that contains external references to
types defined in clang modules or precompiled headers instead of
emitting redundant debug type information into every object file.
- This option implies `-fmodule-format=obj`.
+ This option implies :option:`-fmodule-format=obj`.
+
+ This option should not be used when building static libraries for
+ distribution to other machines because the debug info will contain
+ references to the module cache on the machine the object files in
+ the library were built on.
.. option:: -fstandalone-debug -fno-standalone-debug
OpenPOWER on IntegriCloud