diff --git a/share/doc/homebrew/C++-Standard-Libraries.md b/share/doc/homebrew/C++-Standard-Libraries.md
index f841044b99..4912832f8b 100644
--- a/share/doc/homebrew/C++-Standard-Libraries.md
+++ b/share/doc/homebrew/C++-Standard-Libraries.md
@@ -1,7 +1,7 @@
 # C++ Standard Libraries
 There are two C++ standard libraries supported by Apple compilers.
 
-The default for 10.8 and earlier is **libstdc++**, supported by Apple GCC compilers, GNU GCC compilers, and clang.
+The default for 10.8 and earlier is **libstdc++**, supported by Apple GCC compilers, GNU GCC compilers, and clang. This was marked deprecated with a warning during compile as of Xcode 8.
 
 The default for 10.9 is **libc++**, which is also the default for clang on older platforms when building C++11 code.