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
diff --git a/docs/UsingLibraries.html b/docs/UsingLibraries.html
index 321a3c6..490fd1a 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