Added an explanation of gccld's behavior when linking in native mode.

Also gives me an excuse to re-commit the file on Tank.

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

diff --git a/docs/CommandGuide/gccld.html b/docs/CommandGuide/gccld.html
index 72d53732e3aa8eea1fff995e65dfe18af961a70e..36a67aff197b7ff1d5afe2bd5a6877ceb834f1e3 100644 (file)
--- a/docs/CommandGuide/gccld.html
+++ b/docs/CommandGuide/gccld.html
@@ -143,6 +143,14 @@ OPTIONS
        <li> -native
        <br>
        Generate a native, machine code executable.
+  <p>
+  When generating native executables, gccld first checks for a bytecode version
+  of the library and links it in, if necessary.  If the library is missing,
+  gccld skips it.  Then, gccld links in the same libraries as native code.
+  <p>
+  In this way, gccld should be able to link in optimized bytecode subsets of
+  common libraries and then link in any part of the library that hasn't been
+  converted to bytecode.
        <p>
 
        <li> -s