From 4d3add0038c1ab5ecee43ddc7792ec237eb21700 Mon Sep 17 00:00:00 2001
From: kanschat <kanschat@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Mon, 15 Aug 2011 23:00:54 +0000
Subject: [PATCH] add more structure

git-svn-id: https://svn.dealii.org/trunk@24080 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/doc/readme.html | 43 ++++++++++++++++++++++++++++++-----------
 1 file changed, 32 insertions(+), 11 deletions(-)

diff --git a/deal.II/doc/readme.html b/deal.II/doc/readme.html
index 33576e059a..c8596bb1d4 100644
--- a/deal.II/doc/readme.html
+++ b/deal.II/doc/readme.html
@@ -22,8 +22,17 @@
     </p>
     <ul>
       <li> <a href="#prerequisites">System requirements</a>
+	<ul>
+	  <li> <a href="#supported">Supported platforms</a>
+	  <li> <a href="#unsupported">Unsupported and partly supported platforms</a>
+	  <li> <a href="#additional-software">Additional software requirements</a>
+	</ul>  
       <li> <a href="#installation">Installation</a>
-      <li> <a href="#configuration-options">Configuration options</a>
+	<ul>
+	  <li>  <a href="#unpacking">Unpacking</a>
+	  <li>  <a href="#configuration">Configuring</a>
+	  <li>  <a href="#building">Building the library</a>
+	  <li> <a href="#configuration-options">Configuration options</a>
          <ul>
 	 <li> <a href="#choose-compiler">Changing the compiler or
                compiler flags</a>
@@ -31,6 +40,7 @@
 	 <li> <a href="#optional-software">Optional interfaces to
       other software packages</a>
 	 </ul>
+	</ul>
       <li> <a href="#problems">Problems, questions, mailing lists</a>
       <li> <a href="#license">License</a>
     </ul>
@@ -40,7 +50,8 @@
     <a name="prerequisites"></a>
     <h2>System requirements</h2>
 
-    <p>
+    <a name="supported"></a>
+    <h3>Supported platforms</h3>
     At present, <acronym>deal.II</acronym> has been
     developed and tested on the following platforms:
     <ul>
@@ -72,7 +83,11 @@
     work, as are other brands of Unix (for example Sun Solaris,
     FreeBSD, or Linux on chips like SPARC, PA-RISC, PowerPC, etc) using
     gcc as compiler, but we do not regularly test them.
-    Furthermore, for the following list of systems, we have collected
+    
+    <a name="unsupported"></a>
+    <h3>Unsupported / partly supported platforms</h3>
+
+    For the following list of systems, we have collected
     our experiences on separate pages:
     <ul>
       <li> <a href="platforms/sgi-irix.html" target="body">SGI
@@ -102,11 +117,10 @@
     describes <a href="porting.html" target="body">porting the library
     to new systems</a>.
     </p>
-
-    <p>
-    </p>
-
-    <p>
+    
+    <a name="additional-software"></a>
+    <h3>Additional software requirements</h3>
+    
     In order to compile and use the <acronym>deal.II</acronym>
     libraries you need to have the following programs installed:
     <ul>
@@ -205,25 +219,32 @@
     <a name="installation"></a>
     <h2>Installation</h2>
 
+    <a name="unpacking"></a>
     <h3>Unpacking</h3>
     The whole library usually comes as a .tar.gz file, that is a
     tarred file archive which is compressed with gzip. After downloading this
     tar file, please unpack it at the position where you want to install the
     deal.II library using either
     <pre>
+
       gunzip deal.II-X.Y.Z.tar.gz
       tar xf deal.II-X.Y.Z.tar
     </pre>
     or, if you have GNU tar with
     <pre>
+
       tar xzf deal.II-X.Y.Z.tar.gz
     </pre>
     Unpacking will create a subdirectory <tt>deal.II</tt> with
-    the whole library wherever you do it).
+    the whole library wherever you do it. Since deal.II does not have
+    a <tt>make install</tt> which would copy the libraries to a final position,
+    this subdirectory is where the built library will reside.
 
+    <a name="configuration"></a>
     <h3>Configuration</h3>
     Unpacking will create a subdirectory <tt>deal.II</tt>. First run
     <pre>
+
       cd deal.II
       ./configure
     </pre>
@@ -244,8 +265,9 @@
     of your own projects</a> to set relevant paths and parameters correctly.
     </p>
 
+    <a name="building"></a>
     <h3>Building the library</h3>
-    After configuring, type <tt>make<tt>, to obtain the following help (this
+    After configuring, type <tt>make</tt>, to obtain the following help (this
     output may change slightly over time, just try it):
 
     <pre>
@@ -339,7 +361,6 @@
     </p>
 
 
-
     <a name="configuration-options"></a>
     <h3>Configuration options</h3>
 
-- 
2.39.5