From: David Wells <wellsd2@rpi.edu>
Date: Tue, 19 Jun 2018 18:13:29 +0000 (-0400)
Subject: Mention the need for manifolds when codim != 0.
X-Git-Tag: v9.1.0-rc1~990^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F6794%2Fhead;p=dealii.git

Mention the need for manifolds when codim != 0.

This resurrects a paragraph from the old boundaries.h module.
---

diff --git a/doc/doxygen/headers/manifold.h b/doc/doxygen/headers/manifold.h
index c009fe7895..0eb3b05b48 100644
--- a/doc/doxygen/headers/manifold.h
+++ b/doc/doxygen/headers/manifold.h
@@ -21,7 +21,7 @@
  *
  * The classes in this module are concerned with the description of the
  * manifold in which the domain that a Triangulation describes lives. This
- * manifold description is necessary in two contexts:
+ * manifold description is necessary in several contexts:
  *
  * <ul>
  *
@@ -62,6 +62,17 @@
  *   described here. The same is, of course, true when integrating boundary
  *   terms (e.g., inhomogenous Neumann boundary conditions).
  *
+ *   <li> Domains with nonzero codimension: In cases where a Triangulation is
+ *   embedded into a higher dimensional space, i.e., whenever the second
+ *   template argument of the Triangulation class is explicitly specified and
+ *   larger than the first (for an example, see step-34), the manifold
+ *   description objects serve as a tool to describe the geometry not only of
+ *   the boundary of the domain but of the domain itself, in case the domain
+ *   is a manifold that is in fact curved. In these cases, one can use the
+ *   Triangulation::set_manifold() function to indicate what manifold
+ *   description to use when refining the curve, or when computing integrals
+ *   using high order mappings.
+ *
  * </ul>
  *
  * In deal.II, a Manifold is seen as a collection of points, together