From a7f56ab893f36065c83d8af87fb51bc6a554980e Mon Sep 17 00:00:00 2001 From: Adrian Prantl Date: Tue, 22 Dec 2015 22:37:22 +0000 Subject: [PATCH] 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 --- clang/docs/CommandGuide/clang.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/clang/docs/CommandGuide/clang.rst b/clang/docs/CommandGuide/clang.rst index 9f6d6f588e5a..2b4569592a9a 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