Add some better documentation.

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

diff --git a/deal.II/deal.II/include/numerics/data_out.h b/deal.II/deal.II/include/numerics/data_out.h
index 6796ebaaffbb1d13cbe68eb3441612e73f434031..2c8aefc248ac20d49e06c40b893219c587f52d3e 100644 (file)
--- a/deal.II/deal.II/include/numerics/data_out.h
+++ b/deal.II/deal.II/include/numerics/data_out.h
@@ -742,15 +742,22 @@ class DataOut_DoFData : public DataOutInterface<patch_dim,patch_space_dim>
  * stored in the base class. Most of the interface and an example of its
  * use is described in the documentation of the base class.
  *
- * The only thing this class offers is the function @p build_patches which
- * loops over all cells of the triangulation stored by the @p attach_dof_handler
- * function of the base class and convert the data on these to actual patches
- * which are the objects that are later output by the functions of the
- * base classes. You can give a parameter to the function which determines
- * how many subdivisions in each coordinate direction are to be performed,
- * i.e. of how many subcells each patch shall consist. Default is one, but
- * for quadratic elements you may want to choose two, for cubic elements three,
- * and so on.
+ * The only thing this class offers is the function build_patches() which
+ * loops over all cells of the triangulation stored by the
+ * attach_dof_handler() function of the base class and convert the data on
+ * these to actual patches which are the objects that are later output by the
+ * functions of the base classes. You can give a parameter to the function
+ * which determines how many subdivisions in each coordinate direction are to
+ * be performed, i.e. of how many subcells each patch shall consist. Default
+ * is one, but you may want to choose a higher number for higher order
+ * elements, so as two for quadratic elements, three for cubic elements three,
+ * and so on. The purpose of this parameter is because most graphics programs
+ * do not allow to specify higher order shape functions in the file formats:
+ * only data at vertices can be plotted and is then shown as a bilinear
+ * interpolation within the interior of cells. This may be insufficient if you
+ * have higher order finite elements, and the only way to achieve better
+ * output is to subdivide each cell of the mesh into several cells for
+ * graphical output.
  *
  * Note that after having called @p build_patches once, you can call one or
  * more of the <tt>write_*</tt> functions of the base classes. You can therefore

diff --git a/deal.II/deal.II/include/numerics/data_out_faces.h b/deal.II/deal.II/include/numerics/data_out_faces.h
index 894088dc1abdfe68dbe0656cb3ea4cb5cf795dfe..f8f582e415bd9b38a1b47b0d3454679b521556e8 100644 (file)
--- a/deal.II/deal.II/include/numerics/data_out_faces.h
+++ b/deal.II/deal.II/include/numerics/data_out_faces.h
@@ -38,7 +38,7 @@ template <int dim> class DoFHandler;
  *
  * The interface of this class is copied from the DataOut
  * class. Furthermore, they share the common parent class
- * DataOut_DoFData(). See the reference of these two classes for a
+ * DataOut_DoFData. See the reference of these two classes for a
  * discussion of the interface.
  *
  *

diff --git a/deal.II/deal.II/include/numerics/data_out_stack.h b/deal.II/deal.II/include/numerics/data_out_stack.h
index 3b364af796025e9aaae43e19ea64ee0305d33c80..62500f5d889afed94d2b6acbbe87007f1a5e790a 100644 (file)
--- a/deal.II/deal.II/include/numerics/data_out_stack.h
+++ b/deal.II/deal.II/include/numerics/data_out_stack.h
@@ -32,7 +32,7 @@ template <int dim> class DoFHandler;
  * space-time output file, or for example to connect the results of
  * solutions of a parameter dependent equation for several parameter
  * value together into one. The interface is mostly modelled after the
- * DataOut class.
+ * DataOut class, see there for some more documentation.
  *
  * We will explain the concept for a time dependent problem, but
  * instead of the time any parameter can be substituted. In our