From: Adrian Prantl Date: Tue, 22 Dec 2015 22:37:22 +0000 (+0000) Subject: Document that we recommend to turn off -gmodules when building a static X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2f39eb6689a0e70e5c81d0f5c910497e08ec0a8a;p=clang Document that we recommend to turn off -gmodules when building a static library for distribution to other machines on the clang man page. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@256287 91177308-0d34-0410-b5e6-96231b3b80d8 --- diff --git a/docs/CommandGuide/clang.rst b/docs/CommandGuide/clang.rst index 9f6d6f588e..2b4569592a 100644 --- a/docs/CommandGuide/clang.rst +++ b/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