Add a section on library dependencies now that GenLibDeps.html is written.

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

1 files changed, 295 insertions, 0 deletions

diff --git a/docs/UsingLibraries.html b/docs/UsingLibraries.html
index 321a3c61d9..490fd1a517 100644
--- a/docs/UsingLibraries.html
+++ b/docs/UsingLibraries.html
@@ -10,6 +10,7 @@
   <li><a href="#abstract">Abstract</a></li>
   <li><a href="#introduction">Introduction</a></li>
   <li><a href="#descriptions">Library Descriptions</a></li>
+  <li><a href="#dependencies">Library Dependencies</a></li>
   <li><a href="#rot">Linkage Rules Of Thumb</a>
 	  <ol>
       <li><a href="#always">Always link LLVMCore, LLVMSupport, LLVMSystem</a>
@@ -149,6 +150,300 @@
 </div>
 
 <!-- ======================================================================= -->
+<div class="doc_section"><a name="dependencies"></a>Library Dependencies</div>
+<div class="doc_text">
+  <p>The following list shows the dependency relationships between libraries.
+  This information can be automatically generated with the
+  <tt>GenLibDeps.pl</tt> utility in the <tt>llvm/utils</tt> directory.</p>
+  <!-- =======NOTE: =========================================================-->
+  <!-- === The following <dl> list is generated automatically by the util ===-->
+  <!-- === named GenLibDeps.pl in the llvm/utils directory. This should   ===-->
+  <!-- === updated whenever new libraries are added, removed, or changed  ===-->
+  <!-- =======NOTE: =========================================================-->
+<dl>
+  <dt><b>libLLVMAnalysis.a</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMArchive.a</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMBCReader.o</li>
+  </ul></dd>
+  <dt><b>libLLVMDataStructure.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMInstrumentation.a</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMLinker.a</b</dt><dd><ul>
+    <li>libLLVMArchive.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMBCReader.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMScalarOpts.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMSparcV9RegAlloc.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMSparcV9LiveVar.o</li>
+    <li>LLVMSparcV9.o</li>
+  </ul></dd>
+  <dt><b>libLLVMSupport.a</b</dt><dd><ul>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMbzip2.o</li>
+  </ul></dd>
+  <dt><b>libLLVMSystem.a</b</dt><dd><ul>
+  </ul></dd>
+  <dt><b>libLLVMTarget.a</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMTransformUtils.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMTransforms.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMipa.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>libLLVMipo.a</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMipa.a</li>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMAnalysis.o</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMAsmParser.o</b</dt><dd><ul>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMBCReader.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMBCWriter.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMCBackend.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMipa.a</li>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMCodeGen.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMCore.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+  </ul></dd>
+  <dt><b>LLVMDataStructure.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMDebugger.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMBCReader.o</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMExecutionEngine.o</li>
+  </ul></dd>
+  <dt><b>LLVMExecutionEngine.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMInterpreter.o</li>
+    <li>LLVMJIT.o</li>
+  </ul></dd>
+  <dt><b>LLVMInstrumentation.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMInterpreter.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMExecutionEngine.o</li>
+  </ul></dd>
+  <dt><b>LLVMJIT.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMSystem.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMExecutionEngine.o</li>
+  </ul></dd>
+  <dt><b>LLVMPowerPC.o</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMProfilePaths.o</b</dt><dd><ul>
+    <li>libLLVMInstrumentation.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMScalarOpts.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMSelectionDAG.o</b</dt><dd><ul>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMSkeleton.o</b</dt><dd><ul>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV8.o</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV9.o</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSparcV9RegAlloc.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMBCWriter.o</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMSparcV9InstrSched.o</li>
+    <li>LLVMSparcV9ModuloSched.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV9InstrSched.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMSparcV9LiveVar.o</li>
+    <li>LLVMSparcV9.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV9LiveVar.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV9ModuloSched.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMSparcV9.o</li>
+  </ul></dd>
+  <dt><b>LLVMSparcV9RegAlloc.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+    <li>LLVMSparcV9LiveVar.o</li>
+    <li>LLVMSparcV9.o</li>
+  </ul></dd>
+  <dt><b>LLVMSupport.o</b</dt><dd><ul>
+    <li>libLLVMSystem.a</li>
+    <li>LLVMbzip2.o</li>
+  </ul></dd>
+  <dt><b>LLVMSystem.o</b</dt><dd><ul>
+  </ul></dd>
+  <dt><b>LLVMTarget.o</b</dt><dd><ul>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMTransformUtils.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMTransforms.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMX86.o</b</dt><dd><ul>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>LLVMCodeGen.o</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMbzip2.o</b</dt><dd><ul>
+  </ul></dd>
+  <dt><b>LLVMipa.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+  <dt><b>LLVMipo.o</b</dt><dd><ul>
+    <li>libLLVMAnalysis.a</li>
+    <li>libLLVMipa.a</li>
+    <li>libLLVMScalarOpts.a</li>
+    <li>libLLVMSupport.a</li>
+    <li>libLLVMTarget.a</li>
+    <li>libLLVMTransformUtils.a</li>
+    <li>LLVMCore.o</li>
+  </ul></dd>
+</dl>
+</div>
+
+<!-- ======================================================================= -->
 <div class="doc_section"><a name="rot">Linkage Rules Of Thumb</a></div>
 <div class="doc_text">
 	<p>This section contains various "rules of thumb" about what files you