From: Duncan P. N. Exon Smith <dexonsmith@apple.com>
Date: Thu, 8 Jan 2015 23:50:26 +0000 (+0000)
Subject: LangRef: Add usage points for distinct MDNodes
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=cce3a8acec071779dc5350e652392ccfc2a91b87;p=llvm

LangRef: Add usage points for distinct MDNodes

Omission pointed out by Sean Silva!

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@225479 91177308-0d34-0410-b5e6-96231b3b80d8
---

diff --git a/docs/LangRef.rst b/docs/LangRef.rst
index 0a1c7768d5a..b3f97de25b4 100644
--- a/docs/LangRef.rst
+++ b/docs/LangRef.rst
@@ -2854,6 +2854,10 @@ Metadata nodes that aren't uniqued use the ``distinct`` keyword. For example:
 
     !0 = distinct !{!"test\00", i32 10}
 
+``distinct`` nodes are useful when nodes shouldn't be merged based on their
+content.  They can also occur when transformations cause uniquing collisions
+when metadata operands change.
+
 A :ref:`named metadata <namedmetadatastructure>` is a collection of
 metadata nodes, which can be looked up in the module symbol table. For
 example: