From a743783c437c9e4da383a087003401df6951a88c Mon Sep 17 00:00:00 2001
From: bangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Sun, 4 Nov 2012 19:36:51 +0000
Subject: [PATCH] Provide pages with a table of contents.

git-svn-id: https://svn.dealii.org/branches/branch_cmake@27351 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/doc/cmake.html  | 51 ++++++++++++++++++++++++++++++++++++--
 deal.II/doc/readme.html | 54 +++++++++++++++++++++--------------------
 2 files changed, 77 insertions(+), 28 deletions(-)

diff --git a/deal.II/doc/cmake.html b/deal.II/doc/cmake.html
index d161e84608..e84fbd1c0e 100644
--- a/deal.II/doc/cmake.html
+++ b/deal.II/doc/cmake.html
@@ -25,9 +25,41 @@
     </p>
 
     <p>
-    TODO: Table of Contents
+    <table class="tutorial" width="50%">
+      <tr><th colspan="2"><b><small>Table of contents</small></b></th></tr>
+      <tr><td valign="top">
+	  <ul>
+	    <li><a href="#operatingconf">Operating the configuration
+	    system</a>
+	    <li><a href="#compiling">Compiling and building only certain
+	    parts</a>
+	    <li><a href="#tuning">Fine tuning the configuration system</a>
+	      <ul>
+		<li><a href="#tuningfeature">Feature configuration</a>
+		<li><a href="#tuningautoconf">Autoconfiguration</a>
+		<li><a href="#tuningext">External library locations</a>
+		<li><a href="#tuningcomp">Component selection</a>
+		<li><a href="#tuningbuild">Build configuration</a>
+		<li><a href="#tuninginstall">Installation</a>
+	      </ul>
+	    <li><a href="#ext">How to use deal.II in your cmake project</a>
+	      <ul>
+		<li><a href="#extfinding">Finding the deal.II library</a>
+		<li><a href="#extcmake">deal.IIConfig.cmake</a>
+		<li><a href="#extsetup">Setting up necessary configuration variables</a>
+	      </ul>
+	    <li><a href="#dev">Developing the <acronym>deal.II</acronym> <code>cmake</code> system</a>
+	      <ul>
+		<li><a href="#devplatform">Writing platform checks</a>
+		<li><a href="#devfeature">Writing feature tests</a>
+	      </ul>
+	  </ul>
+	</td>
+      </tr>
+    </table>
     </p>
 
+    <a name="operatingconf"></a>
     <h3>Operating the configuration system</h3>
 
     <p>
@@ -112,6 +144,7 @@
     </p>
 
 
+    <a name="compiling"></a>
     <h3> Compiling and building only certain parts </h3>
 
     <p>
@@ -154,6 +187,7 @@
     </p>
 
 
+    <a name="tuning"></a>
     <h3>Fine tuning the configuration system</h3>
 
     <p>
@@ -162,6 +196,7 @@
     </p>
 
 
+    <a name="tuningfeature"></a>
     <h4>Feature configuration</h4>
 
     <p>
@@ -244,6 +279,7 @@
     </p>
 
 
+    <a name="tuningautoconf"></a>
     <h4> Autoconfiguration </h4>
 
     <p>
@@ -272,6 +308,7 @@
     </p>
 
 
+    <a name="tuningext"></a>
     <h4> External library locations </h4>
 
     <p>
@@ -344,6 +381,7 @@
     </p>
 
 
+    <a name="tuningcomp"></a>
     <h4> Component selection </h4>
 
     <p>
@@ -375,6 +413,7 @@
     </p>
 
 
+    <a name="tuningbuild"></a>
     <h4> Build configuration </h4>
 
     <p>
@@ -424,6 +463,7 @@
     </p>
 
 
+    <a name="tuninginstall"></a>
     <h4> Installation </h4>
 
     <p>
@@ -474,6 +514,7 @@
     </p>
 
 
+    <a name="ext"></a>
     <h3> How to use deal.II in your cmake project </h3>
 
     <p>
@@ -483,6 +524,7 @@
     </p>
 
 
+    <a name="extfinding"></a>
     <h4> Finding the deal.II library </h4>
 
     <p>
@@ -513,6 +555,7 @@
     </p>
 
 
+    <a name="extcmake"></a>
     <h4>  deal.IIConfig.cmake </h4>
 
     <p>
@@ -548,6 +591,7 @@
 
 
 
+    <a name="extsetup"></a>
     <h4> Setting up necessary configuration variables </h4>
 
     <p>
@@ -683,7 +727,8 @@
     </p>
 
 
-    <h3> Development </h3>
+    <a name="dev"></a>
+    <h3> Developing the <acronym>deal.II</acronym> <code>cmake</code>system </h3>
 
     <p>
       To keep things clean, only the following variables should appended in the
@@ -761,6 +806,7 @@
     </p>
 
 
+    <a name="devplatform"></a>
     <h4>  Writing platform checks </h4>
 
     <p>
@@ -839,6 +885,7 @@
     </p>
 
 
+    <a name="devfeature"></a>
     <h4> Writing feature tests </h4>
 
     <p>
diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html
index ff9a5dc18d..1c8f43911c 100644
--- a/deal.II/doc/readme.html
+++ b/deal.II/doc/readme.html
@@ -17,32 +17,34 @@
     <h1>Installation instructions and further information
       on <acronym>deal.II</acronym> </h1>
 
-    <p>
-      This document contains the following sections:
-    </p>
-    <ul>
-      <li> <a href="#prerequisites">System requirements</a>
-	<ul>
-	  <li> <a href="#supported">Supported platforms</a>
-	  <li> <a href="#additional-software">Additional software requirements</a>
-	</ul>
-      <li> <a href="#installation">Installation</a>
-	<ul>
-	  <li>  <a href="#unpacking">Unpacking</a>
-	  <li>  <a href="#configuration">Configuring and building the library</a>
-	  <li>  <a href="#configuration-options">Configuration options</a>
-            <ul>
-	      <li> <a href="#optional">Selecting optional behavior</a>
-	      <li> <a href="#optional-software">Optional interfaces to
-		  other software packages</a>
-	      <li> <a href="#conf-details">More information on configuring
-		  and building the library</a>
-	    </ul>
-	</ul>
-      <li> <a href="#problems">Problems, questions, mailing lists</a>
-      <li> <a href="#license">License</a>
-    </ul>
-
+    <table class="tutorial" width="60%">
+      <tr><th colspan="2"><b><small>Table of contents</small></b></th></tr>
+      <tr><td valign="top">
+	  <ul>
+	    <li> <a href="#prerequisites">System requirements</a>
+	      <ul>
+		<li> <a href="#supported">Supported platforms</a>
+		<li> <a href="#additional-software">Additional software requirements</a>
+	      </ul>
+	    <li> <a href="#installation">Installation</a>
+	      <ul>
+		<li>  <a href="#unpacking">Unpacking</a>
+		<li>  <a href="#configuration">Configuring and building the library</a>
+		<li>  <a href="#configuration-options">Configuration options</a>
+		  <ul>
+		    <li> <a href="#optional">Selecting optional behavior</a>
+		    <li> <a href="#optional-software">Optional interfaces to
+			other software packages</a>
+		    <li> <a href="#conf-details">More information on configuring
+			and building the library</a>
+		  </ul>
+	      </ul>
+	    <li> <a href="#problems">Problems, questions, mailing lists</a>
+	    <li> <a href="#license">License</a>
+	  </ul>
+	</td>
+      </tr>
+    </table>
 
 
     <a name="prerequisites"></a>
-- 
2.39.5