[PATCH] D15343: docs: Correct wording in LangRef relating to available_externally linkage.

[Peter Collingbourne via llvm-commits]

pcc created this revision.
pcc added reviewers: rafael, joker.eph.
pcc added a subscriber: llvm-commits.

http://reviews.llvm.org/D15343

Files:
  docs/LangRef.rst

Index: docs/LangRef.rst
===================================================================
--- docs/LangRef.rst
+++ docs/LangRef.rst
@@ -204,13 +204,15 @@
     (``STB_LOCAL`` in the case of ELF) in the object file. This
     corresponds to the notion of the '``static``' keyword in C.
 ``available_externally``
-    Globals with "``available_externally``" linkage are never emitted
-    into the object file corresponding to the LLVM module. They exist to
-    allow inlining and other optimizations to take place given knowledge
-    of the definition of the global, which is known to be somewhere
-    outside the module. Globals with ``available_externally`` linkage
-    are allowed to be discarded at will, and are otherwise the same as
-    ``linkonce_odr``. This linkage type is only allowed on definitions,
+    Globals with "``available_externally``" linkage are never emitted into
+    the object file corresponding to the LLVM module. From the linker's
+    perspective, an ``available_externally`` global is equivalent to
+    an external declaration. They exist to allow inlining and other
+    optimizations to take place given knowledge of the definition of the
+    global, which is known to be somewhere outside the module. Globals
+    with ``available_externally`` linkage are allowed to be discarded
+    at will, and allow inlining and other optimizations like globals with
+    ``linkonce_odr`` linkage. This linkage type is only allowed on definitions,
     not declarations.
 ``linkonce``
     Globals with "``linkonce``" linkage are merged with other globals of


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D15343.42203.patch
Type: text/x-patch
Size: 1588 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20151208/de13c332/attachment.bin>