Add hp paper. Add comment.

git-svn-id: https://svn.dealii.org/trunk@14746 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/doc/doxygen/headers/glossary.h b/deal.II/doc/doxygen/headers/glossary.h
index 620d776a8c4eafb8337764612e293a169c2be0cf..155706790334049c7a87f0530528bae9acb9f864 100644 (file)
--- a/deal.II/doc/doxygen/headers/glossary.h
+++ b/deal.II/doc/doxygen/headers/glossary.h
@@ -112,6 +112,19 @@
  * </dd>
  *
  *
+ * <dt class="glossary">@anchor hp_paper hp paper</dt>
+ * <dd>The "hp paper" is a paper by W. Bangerth and O. Kayser-Herold, titled
+ * "Data Structures and Requirements for hp Finite Element Software", that
+ * describes many of the algorithms and data structures used in the implementation
+ * of the hp framework of deal.II. In particular, it summarizes many of the
+ * tricky points that have to be considered for hp finite elements using continuous
+ * elements.
+ *
+ * The paper will appear in the ACM Transactions on Mathematical Software (TOMS)
+ * but is also available from http://www.math.tamu.edu/~bangerth/publications.html .
+ * </dd>
+ *
+ *
  * <dt class="glossary">@anchor GlossInterpolation Interpolation with finite elements</dt>
  * <dd>The purpose of interpolation with finite elements is computing
  * a vector of coefficients representing a finite element function,

diff --git a/deal.II/doc/doxygen/headers/hp.h b/deal.II/doc/doxygen/headers/hp.h
index 1b2ddbc82c89fb7e64b6e140b5858ce68d212487..8e1ce0c7113829fe00bc604a5207b082bfe47717 100644 (file)
--- a/deal.II/doc/doxygen/headers/hp.h
+++ b/deal.II/doc/doxygen/headers/hp.h
@@ -2,7 +2,7 @@
 //    $Id$
 //    Version: $Name$
 //
-//    Copyright (C) 2003, 2005, 2006 by the deal.II authors
+//    Copyright (C) 2003, 2005, 2006, 2007 by the deal.II authors
 //
 //    This file is subject to QPL and may not be  distributed
 //    without copyright and license information. Please refer
@@ -15,7 +15,12 @@
  * @defgroup hp hp finite element support
  *
  * Classes and functions that have to do with hp finite elements. See the
- * step-21 tutorial program for an example of how to use these classes.
+ * step-27 tutorial program for an example of how to use these classes.
+ *
+ * The hp namespace implements the algorithms and data structures used for
+ * the hp framework in deal.II. An overview over the details of how these
+ * algorithms work and what data structures are used is given in the
+ * @ref hp_paper "hp paper".
  */
 
 /**
@@ -84,3 +89,12 @@
  */
 
 
+/**
+ * A namespace for the implementation of hp finite element specific algorithms
+ * and data structures.
+ *
+ * @ingroup hp
+ */
+namespace hp
+{
+}