1 files changed, 19 insertions, 5 deletions

diff --git a/usr.bin/clang/clang/clang.1 b/usr.bin/clang/clang/clang.1
index df6fcc7df0f9..24207222575b 100644
--- a/usr.bin/clang/clang/clang.1
+++ b/usr.bin/clang/clang/clang.1
@@ -1,5 +1,5 @@
 .\" $FreeBSD$
-.Dd November 18, 2013
+.Dd February 25, 2015
 .Dt CLANG 1
 .Os
 .Sh NAME
@@ -175,7 +175,7 @@ a number of cross compilers, or may only support a native target.
 .It  Sy -arch Em architecture
 Specify the architecture to build for.
 .It  Sy -mmacosx-version-min Ns = Ns  Em version
-When building for Mac OS/X, specify the minimum version supported by your
+When building for Mac OS X, specify the minimum version supported by your
 application.
 .It  Sy -miphoneos-version-min
 When building for iPhone OS, specify the minimum version supported by your
@@ -230,8 +230,22 @@ Currently equivalent to
 .It  Sy -g
 Generate debug information.  Note that Clang debug information works best at
 .Sy -O0 .
-At higher optimization levels, only line number information is
-currently available.
+.It  Sy -fstandalone-debug Sy -fno-standalone-debug
+Clang supports a number of optimizations to reduce the size of debug
+information in the binary. They work based on the assumption that the
+debug type information can be spread out over multiple compilation
+units.  For instance, Clang will not emit type definitions for types
+that are not needed by a module and could be replaced with a forward
+declaration.  Further, Clang will only emit type info for a dynamic
+C++ class in the module that contains the vtable for the class.
+.Pp
+The 
+.Sy -fstandalone-debug
+option turns off these optimizations.  This
+is useful when working with 3rd-party libraries that don't come with
+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.
 .It  Sy -fexceptions
 Enable generation of unwind information, this allows exceptions to be thrown
 through Clang compiled stack frames.  This is on by default in x86-64.
@@ -262,7 +276,7 @@ to the linker depending on the stage selection options).
 .Ss Driver Options
 .Bl -tag -width Ds
 .It  Sy -###
-Print the commands to run for this compilation.
+Print (but do not run) the commands to run for this compilation.
 .It  Sy --help
 Display available options.
 .It  Sy -Qunused-arguments