]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Augment documentation.
authorWolfgang Bangerth <bangerth@math.tamu.edu>
Wed, 24 Oct 2012 15:38:38 +0000 (15:38 +0000)
committerWolfgang Bangerth <bangerth@math.tamu.edu>
Wed, 24 Oct 2012 15:38:38 +0000 (15:38 +0000)
git-svn-id: https://svn.dealii.org/trunk@27192 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/include/deal.II/lac/precondition_block.h

index 082228dfd4708e5e86301d9eb5d686c3aa8f9b33..e1519e6334aa4f64353d9de2806a8bb9a2186d34 100644 (file)
@@ -35,16 +35,23 @@ class PreconditionBlockJacobi;
  * Base class for actual block preconditioners. This class assumes the
  * <tt>MATRIX</tt> consisting of invertible blocks of @p blocksize on
  * the diagonal and provides the inversion of the diagonal blocks of
- * the matrix. NOT only block diagonal matrices are allowed but all
+ * the matrix. It is not necessary for this class that the matrix be
+ * block diagonal; rather, it applies to
  * matrices of arbitrary structure with the minimal property of having
- * invertible blocks on the diagonal! Still the matrix must have
- * access to single matrix entries. therefore, BlockMatrixArray is not
- * a possible matrix class.
+ * invertible blocks on the diagonal. Still the matrix must have
+ * access to single matrix entries. Therefore, BlockMatrixArray and similar
+ * classes are not a possible matrix class template arguments.
  *
- * This block matrix structure is given e.g. for the DG method for the
- * transport equation. For a downstream numbering the matrices even
- * have got a block lower left matrix structure, i.e. the matrices are
- * empty above the diagonal blocks.
+ * The block matrix structure used by this class is given, e.g., for
+ * the DG method for the transport equation. For a downstream
+ * numbering the matrices even have got a block lower left matrix
+ * structure, i.e. the matrices are empty above the diagonal blocks.
+ *
+ * @note This class is intended to be used for matrices whose structure
+ * is given by local contributions from disjoint cells, such as for DG
+ * methods. It is not intended for problems where the block structure
+ * results from different physical variables such as in the Stokes
+ * equations considered in step-22.
  *
  * For all matrices that are empty above and below the diagonal blocks
  * (i.e. for all block diagonal matrices) the @p BlockJacobi

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.