Index: LangRef.html
===================================================================
--- LangRef.html	(revision 93124)
+++ LangRef.html	(working copy)
@@ -25,6 +25,7 @@
           <li><a href="#linkage_private">'<tt>private</tt>' Linkage</a></li>
           <li><a href="#linkage_linker_private">'<tt>linker_private</tt>' Linkage</a></li>
           <li><a href="#linkage_internal">'<tt>internal</tt>' Linkage</a></li>
+          <li><a href="#linkage_external">'<tt>external</tt>' Linkage</a></li>
           <li><a href="#linkage_available_externally">'<tt>available_externally</tt>' Linkage</a></li>
           <li><a href="#linkage_linkonce">'<tt>linkonce</tt>' Linkage</a></li>
           <li><a href="#linkage_common">'<tt>common</tt>' Linkage</a></li>
@@ -547,6 +548,26 @@ define i32 @main() {                    
       (<tt>STB_LOCAL</tt> in the case of ELF) in the object file. This
       corresponds to the notion of the '<tt>static</tt>' keyword in C.</dd>
 
+  <dt><tt><b><a name="linkage_external">external</a></b></tt></dt>
+  <dd>A symbol defined in another object file, to be resolved by the linker.
+      <tt>external</tt> symbols may not have an initializer.  <tt>external</tt>
+      linkage is useful, for example, to implement the '<tt>extern</tt>' keyword
+      in C.  (Note that unlike C a symbol defined as <tt>external</tt> may not
+      be redefined, and thus the language front-end must determine which
+      translation unit, if any, contains the actual object to which the
+      <tt>external</tt> reference should resolve and emit a definition with
+      the appropriate linkage there).</dd>
+
+<div class="doc_code">
+<pre>
+<i>; file foo.ll</i>
+<i>    @foo = global i32 0</i><i>
+<i>...</i>
+<i>; file usesfoo.ll</i>
+<i>    @foo = external global i32</i><i>; resolves to @foo in foo.ll</i>
+</pre>
+</div>
+
   <dt><tt><b><a name="linkage_available_externally">available_externally</a></b></tt></dt>
   <dd>Globals with "<tt>available_externally</tt>" linkage are never emitted
       into the object file corresponding to the LLVM module.  They exist to
