From 9327e9d49bc51f9b2033bd7955d196deb0129355 Mon Sep 17 00:00:00 2001
From: bangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Tue, 27 Nov 2012 14:10:29 +0000
Subject: [PATCH] Minor markup fixes.

git-svn-id: https://svn.dealii.org/trunk@27696 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/include/deal.II/lac/sparse_matrix.h   | 28 +++++++++++--------
 .../include/deal.II/lac/sparse_matrix_ez.h    |  9 ++++--
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/deal.II/include/deal.II/lac/sparse_matrix.h b/deal.II/include/deal.II/lac/sparse_matrix.h
index 6cdf1e8f2a..6ec462b0f6 100644
--- a/deal.II/include/deal.II/lac/sparse_matrix.h
+++ b/deal.II/include/deal.II/lac/sparse_matrix.h
@@ -27,11 +27,15 @@ template <typename number> class FullMatrix;
 template <typename Matrix> class BlockMatrixBase;
 template <typename number> class SparseILU;
 
-/*! @addtogroup Matrix1
- *@{
+/**
+ * @addtogroup Matrix1
+ * @{
  */
 
-
+/**
+ * A namespace in which we declare iterators over the elements of sparse
+ * matrices.
+ */
 namespace SparseMatrixIterators
 {
   // forward declaration
@@ -1263,9 +1267,6 @@ public:
                     const unsigned int index) const;
 
   /**
-   * @internal @deprecated Use iterator or
-   * const_iterator instead!
-   *
    * This is for hackers. Get
    * access to the <i>i</i>th element of
    * this matrix. The elements are
@@ -1284,16 +1285,19 @@ public:
    * also rename this function to
    * avoid programs relying on
    * outdated information!
+   *
+   * @internal @deprecated Use iterator or
+   * const_iterator instead!
    */
   number global_entry (const unsigned int i) const;
 
   /**
-   * @internal @deprecated Use iterator or
-   * const_iterator instead!
-   *
    * Same as above, but with write
    * access.  You certainly know
    * what you do?
+   *
+   * @internal @deprecated Use iterator or
+   * const_iterator instead!
    */
   number &global_entry (const unsigned int i);
 
@@ -2012,7 +2016,7 @@ public:
    * not more.
    */
   void block_read (std::istream &in);
-//@}
+  //@}
   /** @addtogroup Exceptions
    * @{ */
 
@@ -2133,7 +2137,9 @@ private:
   template <typename> friend class BlockMatrixBase;
 };
 
-/*@}*/
+/**
+ * @}
+ */
 
 #ifndef DOXYGEN
 /*---------------------- Inline functions -----------------------------------*/
diff --git a/deal.II/include/deal.II/lac/sparse_matrix_ez.h b/deal.II/include/deal.II/lac/sparse_matrix_ez.h
index a78992d9a0..08718a1c62 100644
--- a/deal.II/include/deal.II/lac/sparse_matrix_ez.h
+++ b/deal.II/include/deal.II/lac/sparse_matrix_ez.h
@@ -25,8 +25,9 @@ DEAL_II_NAMESPACE_OPEN
 template<typename number> class Vector;
 template<typename number> class FullMatrix;
 
-/*! @addtogroup Matrix1
- *@{
+/**
+ * @addtogroup Matrix1
+ * @{
  */
 
 /**
@@ -1076,7 +1077,9 @@ private:
    */
 };
 
-/*@}*/
+/**
+ * @}
+ */
 /*---------------------- Inline functions -----------------------------------*/
 
 template <typename number>
-- 
2.39.5