From 9f5aef8b2cd60e5e56680598c562d92a532b68fd Mon Sep 17 00:00:00 2001
From: guido <guido@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Tue, 12 Jul 2005 22:00:41 +0000
Subject: [PATCH] minor improvements on last changes

git-svn-id: https://svn.dealii.org/trunk@11127 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/doc/doxygen/headers/deal.II/dox.h     |  7 ++-
 .../doc/doxygen/headers/deal.II/glossary.h    | 58 ++++++++++++++++++-
 .../doc/doxygen/headers/deal.II/iterators.h   | 23 ++++++--
 3 files changed, 82 insertions(+), 6 deletions(-)

diff --git a/deal.II/doc/doxygen/headers/deal.II/dox.h b/deal.II/doc/doxygen/headers/deal.II/dox.h
index dcd09fdc13..20d5c8a416 100644
--- a/deal.II/doc/doxygen/headers/deal.II/dox.h
+++ b/deal.II/doc/doxygen/headers/deal.II/dox.h
@@ -12,7 +12,7 @@
 //-------------------------------------------------------------------------
 
 /**
- * @defgroup grid Grids
+ * @defgroup grid Grid Classes
  */
 
 /**
@@ -21,6 +21,11 @@
 
 /**
  * @defgroup feall Finite Elements
+ *
+ * All classes related to shape functions and to access to shape
+ * functions.  This concerns the actual values of finite elements. For
+ * the numbering of degrees of freedom refer to @ref dofs.
+ *
  * @{
  */
 /**
diff --git a/deal.II/doc/doxygen/headers/deal.II/glossary.h b/deal.II/doc/doxygen/headers/deal.II/glossary.h
index 921c87687b..9bb457659f 100644
--- a/deal.II/doc/doxygen/headers/deal.II/glossary.h
+++ b/deal.II/doc/doxygen/headers/deal.II/glossary.h
@@ -3,8 +3,64 @@
  *
  * <dl>
  *
- * <dt>@anchor GlossActive active cells</dt>
+ * <dt>@anchor GlossActive Active cells</dt>
  * <dd>Mesh cells not refined any further in the hierarchy.</dd>
  *
+ * <dt>@anchor GlossGeneralizedSupport Generalized support points</dt>
+ * <dd>While @ref GlossSupport "support points" allow very simple interpolation
+ * into the finite element space, their concept is restricted to
+ * @ref GlossLagrange "Lagrange elements". For other elements, more general
+ * interpolation operators can be defined, often relying on integral values
+ * or moments. Since these integral values are again computed using a
+ * Quadrature rule, we consider them a generalization of support
+ * points.
+ *
+ * Note that there is no simple relation between
+ * @ref GlossShape "shape functions" and generalized support points as for
+ * regular @ref GlossSupport "support points". Instead, FiniteElement defines
+ * a couple of interpolation functions doing the actual interpolation.
+ *
+ * @note If a finite element is Lagrangian, generalized support points
+ * and support points coincide.
+ *
+ * </dd>
+ *
+ * <dt>@anchor GlossLagrange Lagrange elements</dt>
+ * <dd>Finite elements based on Lagrangian interpolation at
+ * @ref GlossSupport "support points".</dd>
+ *
+ * <dt>@anchor GlossReferenceCell Reference cell</dt>
+ * <dd>The hypercube [0,1]<sup>dim</sup>, on which all parametric finite
+ * element shape functions are defined.</dd>
+ *
+ * <dt>@anchor GlossSupport Support points</dt>
+ * <dd>Support points are by definition those points <i>p<sub>i</sub></i>,
+ * such that for the shape functions <i>v<sub>j</sub></i> holds
+ * <i>v<sub>j</sub>(p<sub>i</sub>) = &delta;<sub>ij</sub></i>. Therefore, a
+ * finite element interpolation can be defined uniquely by the values in the
+ * support points.
+ *
+ * Lagrangian elements fill the vector accessed by
+ * FiniteElementBase::get_unit_support_points(), such that the
+ * function FiniteElementBase::has_support_points() returns
+ * <tt>true</tt>. Naturally, these support points are on the
+ * @ref GlossReferenceCell "reference cell".  Then, FEValues can be used
+ * (in conjuncton with a Mapping) to access support points on the
+ * actual grid cells.
+ *
+ * @note The concept of @ref GlossSupport "support points" is
+ * restricted to the finite element families based on Lagrange
+ * interpolation. For a more general concept, see
+ * @ref GlossGeneralizedSupport "generalized support points".
+ * </dd>
+ *
+ * <dt>@anchor GlossUnitCell Unit cell</dt>
+ * <dd>See @ref GlossReferenceCell "Reference cell".</dd>
+ *
+ * <dt>@anchor GlossUnitSupport Unit support points</dt>
+ * <dd>@ref GlossSupport "Support points" on the reference cell, defined in
+ * FiniteElementBase.
+ * </dd>
+ *
  * </dl>
  */
diff --git a/deal.II/doc/doxygen/headers/deal.II/iterators.h b/deal.II/doc/doxygen/headers/deal.II/iterators.h
index 6d6e387f68..9fea967019 100644
--- a/deal.II/doc/doxygen/headers/deal.II/iterators.h
+++ b/deal.II/doc/doxygen/headers/deal.II/iterators.h
@@ -1,5 +1,5 @@
 /**
-@page Iterators Iterators on mesh like containers
+ @defgroup Iterators Iterators on mesh like containers
 
 deal.II has several classes which are understood conceptionally as
 meshes. Apart from the obvious Triangulation, these are DoFHandler and
@@ -58,10 +58,10 @@ distinction is only in the Accessor.
 
 The standard loops are
 <dl>
-<dt>TriaIterator</tt>
+<dt>TriaIterator</dt>
 <dd>Traverse all cells on all levels</dd>
 
-<dt>TriaActiveIterator</tt>
+<dt>TriaActiveIterator</dt>
 <dd>Loop over @ref GlossActive "active cells" only</dd> 
 </dl>
 
@@ -73,7 +73,6 @@ is determined by the Accessor. The magic is, that for any iterator
 <tt>i</tt>, the term <tt>i-&gt;</tt> grants access to <b>all</b>
 attributes of this Accessor.
 
-
 @section IteratorsTypedefs Iterators defined in the containers
 
 The standard iterators are typedefed inside the classes. These are
@@ -82,4 +81,20 @@ The standard iterators are typedefed inside the classes. These are
 <tr><th></th>
 <th>cell_iterator</th>
 <th>face_iterator</th>
+</tr>
+<tr>
+<th>Triangulation</th>
+<td>TriaIterator&lt;dim, CellAccessor&lt;dim&gt; &gt;</td>
+<td>TriaIterator&lt;dim, TriaObjectAccessor&lt;dim-1, dim&gt; &gt;</td>
+</tr>
+<tr>
+<th>DoFHandler</th>
+<td>TriaIterator&lt;dim, DoFCellAccessor&lt;dim&gt; &gt;</td>
+<td>TriaIterator&lt;dim, DoFObjectAccessor&lt;dim-1, dim&gt; &gt;</td>
+</tr>
 </table>
+
+@section IteratorsFiltered Filtered iterators
+...
+*/
+
-- 
2.39.5