diff --git a/docs/LangRef.html b/docs/LangRef.html
index 384c1201fa1..ab86271f333 100644
--- a/docs/LangRef.html
+++ b/docs/LangRef.html
@@ -529,7 +529,11 @@ define i32 @main() { ; i32()*
linker_private:
Similar to private, but the symbol is passed through the assembler and
- removed by the linker after evaluation.
+ removed by the linker after evaluation. Note that (unlike private
+ symbols) linker_private 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).
internal:
Similar to private, but the value shows as a local symbol