]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Split the one big overview page into several individual ones.
authorWolfgang Bangerth <bangerth@math.tamu.edu>
Tue, 22 Jun 2010 16:33:02 +0000 (16:33 +0000)
committerWolfgang Bangerth <bangerth@math.tamu.edu>
Tue, 22 Jun 2010 16:33:02 +0000 (16:33 +0000)
git-svn-id: https://svn.dealii.org/trunk@21266 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/doc/doxygen/tutorial/Makefile
deal.II/doc/doxygen/tutorial/make_toc.pl
deal.II/doc/doxygen/tutorial/navbar.html
deal.II/doc/doxygen/tutorial/toc-list.html [new file with mode: 0644]
deal.II/doc/doxygen/tutorial/toc-map.html.in [new file with mode: 0644]
deal.II/doc/doxygen/tutorial/toc-topics.html [moved from deal.II/doc/doxygen/tutorial/toc.html.in with 52% similarity]
deal.II/doc/doxygen/tutorial/toc.html [new file with mode: 0644]

index 28793c901d7438d1a83a4642d3129d5feaafc3ca..2906552ea0eca501ebddc895be2775c526ef3853 100644 (file)
@@ -39,9 +39,9 @@ get_basename = $(shell echo $(1) | $(PERL) -pi -e 's/(generated|doxygen).//g; s/
 
 all: $(example-doxygen) toc.html
 
-toc.html: steps.cmapx toc.html.in $D/examples/step-*/doc/tooltip
+toc-map.html: steps.cmapx toc-map.html.in
        @echo ================== Making $@
-       @perl make_toc.pl > toc.html
+       @perl make_toc.pl > toc-map.html
 
 # generate dot file
 steps.dot: steps.pl $D/examples/*/doc/tooltip
index eb6ab2b6b12886db16fe1f74e9e7883578bb75e4..6b26b152ba333fa39ab9434274e6e1a23fbe0787 100644 (file)
@@ -5,7 +5,7 @@
 $/ = undef;
 
 # Read source for web page
-open TOC, "<toc.html.in";
+open TOC, "<toc-map.html.in";
 $toc = <TOC>;
 close TOC;
 
index ebcfed7f46c5adf8d775dcdf7958944eb29e50fc..2e1fa6ea9650da64e866e910441b67679e4ca815 100644 (file)
@@ -5,7 +5,7 @@
 <title>Step-by-Step Examples</title>
   <link href="../../screen.css" rel="StyleSheet" type="text/css">
   <meta name="author" content="the deal.II authors <authors@dealii.org>">
-  <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009 by the deal.II authors">
+  <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
   <meta name="date" content="$Date$">
   <meta name="svn_id" content="$Id$">
   <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
 
 
        <p>
-         <a href="toc.html#overview" target="body">Overview</a>
+         <a href="toc.html" target="body">Overview</a>
        </p>
        <p>
-         <a href="toc.html#bynumber" target="body">Programs by number</a>
+         <a href="toc-map.html" target="body">Connections between programs</a>
        </p>
        <p>
-         <a href="toc.html#bytopic" target="body">Programs by topic</a>
+         <a href="toc-list.html" target="body">Programs by number</a>
+       </p>
+       <p>
+         <a href="toc-topics.html" target="body">Programs by topic</a>
        </p>
 
        <hr>
diff --git a/deal.II/doc/doxygen/tutorial/toc-list.html b/deal.II/doc/doxygen/tutorial/toc-list.html
new file mode 100644 (file)
index 0000000..71fdfae
--- /dev/null
@@ -0,0 +1,245 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+  <meta name="author" content="the deal.II authors <authors@dealii.org>">
+  <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+  <meta name="date" content="$Date$">
+  <meta name="svn_id" content="$Id$">
+  <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+<h2>Tutorial programs listed by number</h2>
+
+<table align="center" width="80%">
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_1.html">Step-1</a></td>
+      <td> Creating a grid. A simple way to write it to a file.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_2.html">Step-2</a></td>
+      <td> Associate degrees of freedom to
+      each vertex and compute the resulting sparsity pattern of
+      matrices. Show that renumbering reduces the bandwidth of
+      matrices significantly, i.e. clusters nonzero entries around the
+      diagonal.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_3.html">Step-3</a></td>
+      <td> Actually solve Laplace's
+      problem. Object-orientation. Assembling matrices and
+      vectors. Boundary values.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_4.html">Step-4</a></td>
+      <td> This example is programmed in a
+      way that it is independent of the dimension for which we want to
+      solve Laplace's equation; we will solve the equation in 2D and
+      3D, although the program is exactly the same. Non-constant right
+      hand side function. Non-homogeneous boundary values.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_5.html">Step-5</a></td>
+      <td> Computations on successively
+      refined grids. Reading a grid from disk. Some optimizations.
+      Using assertions. Non-constant coefficient in
+      the elliptic operator. Preconditioning the CG solver for the
+      linear system of equations.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_6.html">Step-6</a></td>
+      <td> Adaptive local
+      refinement. Handling of hanging nodes. Higher order elements.
+      Catching exceptions in the &#8220;main&#8221; function.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_7.html">Step-7</a></td>
+      <td> Helmholtz
+      equation. Non-homogeneous Neumann boundary conditions and
+      boundary integrals. Verification of correctness of computed
+      solutions. Computing the error between exact and numerical
+      solution and output of the data in tables. Using counted pointers.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_8.html">Step-8</a></td>
+      <td> The elasticity equations will be
+      solved instead of Laplace's equation. The solution is
+      vector-valued and the equations form a system with as many
+      equations as the dimension of the space in which it is posed.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_9.html">Step-9</a></td>
+      <td> Linear advection equation, assembling
+      the system of equations in parallel using multi-threading,
+      implementing a refinement criterion based on a finite difference
+      approximation of the gradient.
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_10.html">Step-10</a></td>
+      <td> Higher order mappings. Do not
+      solve equations, but rather compute the value of pi to high
+      accuracy.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_11.html">Step-11</a></td>
+      <td> Solving a Laplace problem with
+      higher order mappings. Using strange constraints and
+      intermediate representations of sparsity patterns.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_12.html">Step-12</a></td>
+      <td> Discontinuous Galerkin methods for linear advection problems.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_13.html">Step-13</a></td>
+      <td> Software design questions and
+      how to write a modular, extensible finite element program.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_14.html">Step-14</a></td>
+      <td> Duality based error estimators,
+      more strategies to write a modular, extensible finite element
+      program.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_15.html">Step-15</a></td>
+      <td> 1d problems, nonlinear solvers,
+      transfering a solution across mesh refinement.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_16.html">Step-16</a></td>
+      <td> Multigrid preconditioning of the Laplace equation on adaptive
+      meshes.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_17.html">Step-17</a></td>
+      <td> Using PETSc for linear algebra; running
+      in parallel on clusters of computers linked together by MPI.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_18.html">Step-18</a></td>
+      <td> A time dependent problem; using a much
+      simplified version of implementing elasticity; moving meshes; handling
+      large scale output of parallel programs.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_19.html">Step-19</a></td>
+      <td> Input parameter file handling. Merging
+      output of a parallel program.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_20.html">Step-20</a></td>
+      <td> Mixed finite elements. Using block
+      matrices and block vectors to define more complicated solvers and
+      preconditioners working on the Schur complement.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_21.html">Step-21</a></td>
+      <td> The time dependent two-phase flow in
+      porous media. Extensions of mixed Laplace discretizations. More
+      complicated block solvers. Simple time stepping.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_22.html">Step-22</a></td>
+      <td> Solving the Stokes equations of slow fluid flow on adaptive
+      meshes. More on Schur complement solvers. Advanced use of the
+      ConstraintMatrix class.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_23.html">Step-23</a></td>
+      <td> Finally a "real" time dependent problem, the wave equation.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_24.html">Step-24</a></td>
+      <td> A variant of step-23 with absorbing
+      boundary conditions, and extracting practically useful data.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_25.html">Step-25</a></td>
+      <td> The sine-Gordon
+      soliton equation, which is a nonlinear variant of the time
+      dependent wave equation covered in step-23 and step-24.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_27.html">Step-27</a></td>
+      <td> hp finite element methods  </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_28.html">Step-28</a></td>
+      <td> Multiple grids for solving a multigroup diffusion equation
+      in nuclear physics simulating a nuclear reactor core  </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_29.html">Step-29</a></td>
+      <td> Solving a complex-valued Helmholtz equation. Sparse direct
+      solvers. Dealing with parameter files.  </td></tr>
+
+  <tr><td><a href="../../doxygen/deal.II/step_30.html">Step-30</a></td>
+      <td> Anisotropic refinement for DG finite element methods.
+      </td></tr>
+
+  <tr><td><a href="../../doxygen/deal.II/step_31.html">Step-31</a></td>
+      <td> Time-dependent Stokes flow driven by temperature
+      differences in a fluid. Adaptive meshes that change between time
+      steps.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_33.html">Step-33</a></td>
+      <td> A nonlinear hyperbolic conservation law: The Euler equations of
+      compressible gas dynamics.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_34.html">Step-34</a></td>
+      <td> Boundary element methods (BEM) of low order: Exterior irrotational
+      flow. The ParsedFunction class.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_35.html">Step-35</a></td>
+      <td> A projection solver for the Navier&ndash;Stokes equations.
+      </td></tr>
+
+  <tr valign="top">
+      <td><a href="../../doxygen/deal.II/step_36.html">Step-36</a></td>
+      <td> Using SLEPc for linear algebra; solving an eigenspectrum
+      problem. The Schr&ouml;dinger wave equation.
+      </td></tr>
+</table>
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>
diff --git a/deal.II/doc/doxygen/tutorial/toc-map.html.in b/deal.II/doc/doxygen/tutorial/toc-map.html.in
new file mode 100644 (file)
index 0000000..e207479
--- /dev/null
@@ -0,0 +1,33 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+  <meta name="author" content="the deal.II authors <authors@dealii.org>">
+  <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+  <meta name="date" content="$Date$">
+  <meta name="svn_id" content="$Id$">
+  <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+
+<h2>Map of tutorial programs</h2>
+
+The following graph shows the connections between tutorial programs.
+Click on any of the boxes to go to one of the programs. If you hover
+your mouse pointer over a box, a brief description of the program
+should appear.
+
+<img src="steps.png" usemap="#StepsMap"\/>
+@@MAP@@
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>
similarity index 52%
rename from deal.II/doc/doxygen/tutorial/toc.html.in
rename to deal.II/doc/doxygen/tutorial/toc-topics.html
index 85bfea1d3f563cf626030510fcc42571177a2f99..e55284a3034e297fa89ea9d64788d2fb7f68acb2 100644 (file)
 <!-- Page Body -->
 <body lang="en">
 
-<a name="overview"></a>
-<h2>Overview</h2>
-
-<p>
-The <acronym>deal.II</acronym> tutorial contains a collection of
-programs, each more
-or less built atop of previous ones, which demonstrate various
-aspects of the library. Each such example has the following structure
-follows:</p>
-<ol>
-  <li> <b>Introduction:</b> A brief description of what the program does and
-       what is new compared to the previous programs. This also includes a
-       discussion of the mathematical model and its formulation.
-  <li> <b>The commented program:</b> A listing of the program, interspersed
-       with many comments that explain what is going on, how things are done
-       and why.
-  <li> <b>Results:</b> The output of the program, with some comments and
-       interpretation.
-  <li> <b>The plain program:</b> Since the program itself usually is a little
-       bit unreadable with all the comments intertwingled, we present the
-       program again, with all comments stripped off, to allow getting an
-       overview of it.
-</ol>
-
-<p>
-The programs can be found at a path which is indicated at
-the beginning of the last section of each example. You can compile
-them by typing <strong>make</strong> in the respective directory, and run them
-using <strong>make run</strong>. The latter command also compiles the program
-if that has not already been done. The Makefiles in the different
-directories are based on the small program Makefile template described
-in <a href="../../development/index.html" target="_top">in this section</a>.
-</p>
-
-<p>
-Below we will list the currently available tutorial programs twice, once
-<a href="#bynumber">in numerical order explaining what is new in each
-program</a> and once <a href="#bytopic">listed by topic</a> to facilitate
-searching for programs with a certain functionality. Some of these programs
-also jointly form
-the <a href="../../doxygen/deal.II/group__geodynamics.html">geodynamics
-  demonstration suite</a>.
-</p>
-
-
-<h2>Map of tutorial programs</h2>
-
-The following graph shows the connections between tutorial programs.
-Click on any of the boxes to go to one of the programs. If you hover
-your mouse pointer over a box, a brief description of the program
-should appear.
-
-<img src="steps.png" usemap="#StepsMap"\/>
-@@MAP@@
-
-<a name="bynumber"></a>
-<h2>Tutorial programs listed by number</h2>
 
-<table align="center" width="80%">
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_1.html">Step-1</a></td>
-      <td> Creating a grid. A simple way to write it to a file.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_2.html">Step-2</a></td>
-      <td> Associate degrees of freedom to
-      each vertex and compute the resulting sparsity pattern of
-      matrices. Show that renumbering reduces the bandwidth of
-      matrices significantly, i.e. clusters nonzero entries around the
-      diagonal.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_3.html">Step-3</a></td>
-      <td> Actually solve Laplace's
-      problem. Object-orientation. Assembling matrices and
-      vectors. Boundary values.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_4.html">Step-4</a></td>
-      <td> This example is programmed in a
-      way that it is independent of the dimension for which we want to
-      solve Laplace's equation; we will solve the equation in 2D and
-      3D, although the program is exactly the same. Non-constant right
-      hand side function. Non-homogeneous boundary values.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_5.html">Step-5</a></td>
-      <td> Computations on successively
-      refined grids. Reading a grid from disk. Some optimizations.
-      Using assertions. Non-constant coefficient in
-      the elliptic operator. Preconditioning the CG solver for the
-      linear system of equations.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_6.html">Step-6</a></td>
-      <td> Adaptive local
-      refinement. Handling of hanging nodes. Higher order elements.
-      Catching exceptions in the &#8220;main&#8221; function.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_7.html">Step-7</a></td>
-      <td> Helmholtz
-      equation. Non-homogeneous Neumann boundary conditions and
-      boundary integrals. Verification of correctness of computed
-      solutions. Computing the error between exact and numerical
-      solution and output of the data in tables. Using counted pointers.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_8.html">Step-8</a></td>
-      <td> The elasticity equations will be
-      solved instead of Laplace's equation. The solution is
-      vector-valued and the equations form a system with as many
-      equations as the dimension of the space in which it is posed.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_9.html">Step-9</a></td>
-      <td> Linear advection equation, assembling
-      the system of equations in parallel using multi-threading,
-      implementing a refinement criterion based on a finite difference
-      approximation of the gradient.
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_10.html">Step-10</a></td>
-      <td> Higher order mappings. Do not
-      solve equations, but rather compute the value of pi to high
-      accuracy.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_11.html">Step-11</a></td>
-      <td> Solving a Laplace problem with
-      higher order mappings. Using strange constraints and
-      intermediate representations of sparsity patterns.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_12.html">Step-12</a></td>
-      <td> Discontinuous Galerkin methods for linear advection problems.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_13.html">Step-13</a></td>
-      <td> Software design questions and
-      how to write a modular, extensible finite element program.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_14.html">Step-14</a></td>
-      <td> Duality based error estimators,
-      more strategies to write a modular, extensible finite element
-      program.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_15.html">Step-15</a></td>
-      <td> 1d problems, nonlinear solvers,
-      transfering a solution across mesh refinement.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_16.html">Step-16</a></td>
-      <td> Multigrid preconditioning of the Laplace equation on adaptive
-      meshes.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_17.html">Step-17</a></td>
-      <td> Using PETSc for linear algebra; running
-      in parallel on clusters of computers linked together by MPI.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_18.html">Step-18</a></td>
-      <td> A time dependent problem; using a much
-      simplified version of implementing elasticity; moving meshes; handling
-      large scale output of parallel programs.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_19.html">Step-19</a></td>
-      <td> Input parameter file handling. Merging
-      output of a parallel program.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_20.html">Step-20</a></td>
-      <td> Mixed finite elements. Using block
-      matrices and block vectors to define more complicated solvers and
-      preconditioners working on the Schur complement.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_21.html">Step-21</a></td>
-      <td> The time dependent two-phase flow in
-      porous media. Extensions of mixed Laplace discretizations. More
-      complicated block solvers. Simple time stepping.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_22.html">Step-22</a></td>
-      <td> Solving the Stokes equations of slow fluid flow on adaptive
-      meshes. More on Schur complement solvers. Advanced use of the
-      ConstraintMatrix class.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_23.html">Step-23</a></td>
-      <td> Finally a "real" time dependent problem, the wave equation.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_24.html">Step-24</a></td>
-      <td> A variant of step-23 with absorbing
-      boundary conditions, and extracting practically useful data.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_25.html">Step-25</a></td>
-      <td> The sine-Gordon
-      soliton equation, which is a nonlinear variant of the time
-      dependent wave equation covered in step-23 and step-24.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_27.html">Step-27</a></td>
-      <td> hp finite element methods  </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_28.html">Step-28</a></td>
-      <td> Multiple grids for solving a multigroup diffusion equation
-      in nuclear physics simulating a nuclear reactor core  </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_29.html">Step-29</a></td>
-      <td> Solving a complex-valued Helmholtz equation. Sparse direct
-      solvers. Dealing with parameter files.  </td></tr>
-
-  <tr><td><a href="../../doxygen/deal.II/step_30.html">Step-30</a></td>
-      <td> Anisotropic refinement for DG finite element methods.
-      </td></tr>
-
-  <tr><td><a href="../../doxygen/deal.II/step_31.html">Step-31</a></td>
-      <td> Time-dependent Stokes flow driven by temperature
-      differences in a fluid. Adaptive meshes that change between time
-      steps.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_33.html">Step-33</a></td>
-      <td> A nonlinear hyperbolic conservation law: The Euler equations of
-      compressible gas dynamics.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_34.html">Step-34</a></td>
-      <td> Boundary element methods (BEM) of low order: Exterior irrotational
-      flow. The ParsedFunction class.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_35.html">Step-35</a></td>
-      <td> A projection solver for the Navier&ndash;Stokes equations.
-      </td></tr>
-
-  <tr valign="top">
-      <td><a href="../../doxygen/deal.II/step_36.html">Step-36</a></td>
-      <td> Using SLEPc for linear algebra; solving an eigenspectrum
-      problem. The Schr&ouml;dinger wave equation.
-      </td></tr>
-</table>
-
-
-<a name="bytopic"></a>
-<h2>Tutorial programs listed by topics</h2>
-
-The existing tutorial programs can be sorted into the following groups sorted
-by topic:
+<h2>Tutorial programs grouped by topics</h2>
 
 <table align="center" width="80%">
   <tr valign="top">
diff --git a/deal.II/doc/doxygen/tutorial/toc.html b/deal.II/doc/doxygen/tutorial/toc.html
new file mode 100644 (file)
index 0000000..d696b07
--- /dev/null
@@ -0,0 +1,80 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+  <meta name="author" content="the deal.II authors <authors@dealii.org>">
+  <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+  <meta name="date" content="$Date$">
+  <meta name="svn_id" content="$Id$">
+  <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+<a name="overview"></a>
+<h2>Overview</h2>
+
+<p>
+The <acronym>deal.II</acronym> tutorial contains a collection of
+programs, each more
+or less built atop of previous ones, which demonstrate various
+aspects of the library. Each such example has the following structure
+follows:</p>
+<ol>
+  <li> <b>Introduction:</b> A brief description of what the program does and
+       what is new compared to the previous programs. This also includes a
+       discussion of the mathematical model and its formulation.
+  <li> <b>The commented program:</b> A listing of the program, interspersed
+       with many comments that explain what is going on, how things are done
+       and why.
+  <li> <b>Results:</b> The output of the program, with some comments and
+       interpretation.
+  <li> <b>The plain program:</b> Since the program itself usually is a little
+       bit unreadable with all the comments intertwingled, we present the
+       program again, with all comments stripped off, to allow getting an
+       overview of it.
+</ol>
+
+<p>
+You can browse through the list of currently available tutorial programs in
+three different ways:
+<ul>
+  <li>In the <a href="toc-map.html">form of a graph</a> that shows how
+  tutorial programs build upon each other.
+
+  <li>In the <a href="toc-list.html">form of a list</a> that provides a short
+  synopsis of what each program does and which new concepts it introduces.
+
+  <li>In the <a href="toc-topics.html">form of groups of topics</a> such as
+  solvers or the kind of equations that different sets of tutorial program
+  address. 
+</ul>
+Some of the programs also jointly form
+the <a href="../../doxygen/deal.II/group__geodynamics.html">geodynamics
+  demonstration suite</a>.
+</p>
+
+
+
+<h3>Usage</h3>
+
+<p>
+The programs are in the <code>examples/</code> directory of your local deal.II
+installation. If you go into one of the tutorial directories, you can compile
+the program by typing <strong>make</strong>, and run it
+using <strong>make run</strong>. The latter command also compiles the program
+if that has not already been done. The Makefiles in the different
+directories are based on the small program Makefile template described
+<a href="../../development/index.html" target="_top">in this section</a>.
+</p>
+
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.