diff --git a/docs/LangRef.html b/docs/LangRef.html
index 282281327f5..1158a5760d8 100644
--- a/docs/LangRef.html
+++ b/docs/LangRef.html
@@ -560,11 +560,15 @@ define i32 @main() {                                        <i>; i32()* </i>
       <tt>private</tt> symbols) <tt>linker_private</tt> symbols are subject to
       coalescing by the linker: weak symbols get merged and redefinitions are
       rejected.  However, unlike normal strong symbols, they are removed by the
-      linker from the final linked image (executable or dynamic library).</dd>
+      linker from the final linked image (executable or dynamic library).
+      This is currently only used for Objective-C metadata.</dd>
 
   <dt><tt><b><a name="linkage_linker_weak">linker_weak</a></b></tt></dt>
   <dd>Global values with "<tt>linker_weak</tt>" linkage are given weak linkage,
-      but are removed by the linker after evaluation.</dd>
+      but are removed by the linker after evaluation. Unlike normal weak
+      symbols, linker weak symbols are removed by the linker from the linal
+      linked image (executable or dynamic library). This is currently only used
+      for Objective-C metadata.</dd>
 
   <dt><tt><b><a name="linkage_internal">internal</a></b></tt></dt>
   <dd>Similar to <tt>private</tt>, but the value shows as a local symbol