diff options
| author | Adrian Prantl <aprantl@apple.com> | 2014-06-13 23:35:54 +0000 |
|---|---|---|
| committer | Adrian Prantl <aprantl@apple.com> | 2014-06-13 23:35:54 +0000 |
| commit | 31c3b80b5f6bb2e6597f660d27cfe5d34146f53b (patch) | |
| tree | e2d4691b4a26f4f8623348f2017d9dffe0dfcbf5 | |
| parent | 461cfc5c98be23dbefdbf953b8a635b74ee546c0 (diff) | |
Document Darwin-specific defaults.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@210958 91177308-0d34-0410-b5e6-96231b3b80d8
| -rw-r--r-- | docs/UsersManual.rst | 10 | ||||
| -rw-r--r-- | docs/tools/clang.pod | 5 |
2 files changed, 11 insertions, 4 deletions
diff --git a/docs/UsersManual.rst b/docs/UsersManual.rst index d6e30bb92c..63154a8d7b 100644 --- a/docs/UsersManual.rst +++ b/docs/UsersManual.rst @@ -1298,7 +1298,7 @@ below. If multiple flags are present, the last one is used. doesn't contain any other data (e.g. description of local variables or function parameters). -.. option:: -fstandalone-debug **-fno-standalone-debug** +.. option:: -fstandalone-debug Clang supports a number of optimizations to reduce the size of debug information in the binary. They work based on the assumption that @@ -1309,11 +1309,17 @@ below. If multiple flags are present, the last one is used. type info for a dynamic C++ class in the module that contains the vtable for the class. - The ``-fstandalone-debug`` option turns off these optimizations. + The **-fstandalone-debug** option turns off these optimizations. This is useful when working with 3rd-party libraries that don't come with debug information. Note that Clang will never emit type information for types that are not referenced at all by the program. +.. option:: -fno-standalone-debug + + On Darwin **-fstandalone-debug** is enabled by default. The + **-fno-standalone-debug** option can be used to get to turn on the + vtable-based optimization described above. + .. option:: -g Generate complete debug info. diff --git a/docs/tools/clang.pod b/docs/tools/clang.pod index 6ccdbba1bb..f7d2eaf683 100644 --- a/docs/tools/clang.pod +++ b/docs/tools/clang.pod @@ -324,8 +324,9 @@ C++ class in the module that contains the vtable for the class. The B<-fstandalone-debug> option turns off these optimizations. This is useful when working with 3rd-party libraries that don't come with -debug information. Note that Clang will never emit type information -for types that are not referenced at all by the program. +debug information. This is the default on Darwin. Note that Clang +will never emit type information for types that are not referenced at +all by the program. =item B<-fexceptions> |