r210958 - Document Darwin-specific defaults.
Adrian Prantl
aprantl at apple.com
Fri Jun 13 16:35:54 PDT 2014
Author: adrian
Date: Fri Jun 13 18:35:54 2014
New Revision: 210958
URL: http://llvm.org/viewvc/llvm-project?rev=210958&view=rev
Log:
Document Darwin-specific defaults.
Modified:
cfe/trunk/docs/UsersManual.rst
cfe/trunk/docs/tools/clang.pod
Modified: cfe/trunk/docs/UsersManual.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/UsersManual.rst?rev=210958&r1=210957&r2=210958&view=diff
==============================================================================
--- cfe/trunk/docs/UsersManual.rst (original)
+++ cfe/trunk/docs/UsersManual.rst Fri Jun 13 18:35:54 2014
@@ -1298,7 +1298,7 @@ below. If multiple flags are present, th
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, th
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.
Modified: cfe/trunk/docs/tools/clang.pod
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/tools/clang.pod?rev=210958&r1=210957&r2=210958&view=diff
==============================================================================
--- cfe/trunk/docs/tools/clang.pod (original)
+++ cfe/trunk/docs/tools/clang.pod Fri Jun 13 18:35:54 2014
@@ -324,8 +324,9 @@ C++ class in the module that contains th
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>
More information about the cfe-commits
mailing list