Integrate dependency graphs.

Make it HTML 4.01 Strict compliant
Provide better explanations of the dependency information.


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

1 files changed, 24 insertions, 12 deletions

diff --git a/docs/UsingLibraries.html b/docs/UsingLibraries.html
index 8aa99699b7..5c24300d1f 100644
--- a/docs/UsingLibraries.html
+++ b/docs/UsingLibraries.html
@@ -158,14 +158,29 @@
 <!-- ======================================================================= -->
 <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>
+  <p>Below are two dependency graphs and a list that show the relationships
+  between the various LLVM archive libraries and object files.  This information 
+  can be automatically generated with the <tt>GenLibDeps.pl</tt> utility found
+  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  ===-->
+  <!-- === The following graphs and <dl> list are generated automatically ===-->
+  <!-- === by the util named GenLibDeps.pl in the llvm/utils directory.   ===-->
+  <!-- === This should be updated whenever new libraries are added,       ===-->
+  <!-- === removed, or changed                                            ===-->
   <!-- =======NOTE: =========================================================-->
+  <h2>Dependency Relationships Of Libraries</h2>
+  <p>This graph shows the dependency of archive libraries on other archive 
+  libraries or objects. Where a library has both archive and object forms, only
+  the archive form is shown.</p>
+  <img src="img/libdeps.gif" alt="Library Dependencies"/>
+  <h2>Dependency Relationships Of Object Files</h2>
+  <p>This graph shows the dependency of object files on archive libraries or 
+  other objects. Where a library has both object and archive forms, only the 
+  dependency to the archive form is shown.</p> 
+  <img src="img/objdeps.gif" alt="Object File Dependencies"/>
+  <p>The following list shows the dependency relationships between libraries in
+  textual form. The information is the same as shown on the graphs but arranged
+  alphabetically.</p>
 <dl>
   <dt><b>libLLVMAnalysis.a</b</dt><dd><ul>
     <li>libLLVMScalarOpts.a</li>
@@ -216,8 +231,7 @@
     <li>libLLVMSystem.a</li>
     <li>LLVMbzip2.o</li>
   </ul></dd>
-  <dt><b>libLLVMSystem.a</b</dt><dd><ul>
-  </ul></dd>
+  <dt><b>libLLVMSystem.a</b</dt><dd></dd>
   <dt><b>libLLVMTarget.a</b</dt><dd><ul>
     <li>libLLVMSupport.a</li>
     <li>LLVMCore.o</li>
@@ -404,8 +418,7 @@
     <li>libLLVMSystem.a</li>
     <li>LLVMbzip2.o</li>
   </ul></dd>
-  <dt><b>LLVMSystem.o</b</dt><dd><ul>
-  </ul></dd>
+  <dt><b>LLVMSystem.o</b</dt><dd></dd>
   <dt><b>LLVMTarget.o</b</dt><dd><ul>
     <li>libLLVMSupport.a</li>
     <li>LLVMCore.o</li>
@@ -430,8 +443,7 @@
     <li>LLVMCodeGen.o</li>
     <li>LLVMCore.o</li>
   </ul></dd>
-  <dt><b>LLVMbzip2.o</b</dt><dd><ul>
-  </ul></dd>
+  <dt><b>LLVMbzip2.o</b</dt><dd></dd>
   <dt><b>LLVMipa.o</b</dt><dd><ul>
     <li>libLLVMAnalysis.a</li>
     <li>libLLVMSupport.a</li>