From 2689f45ce0d3056ca95542cafa0256a837d506a7 Mon Sep 17 00:00:00 2001
From: Chengjiang Yin <richard_ycj@outlook.com>
Date: Sun, 9 Jul 2023 20:48:37 +0800
Subject: [PATCH] Fix incorrect and missing doxygen-style name brackets

---
 include/deal.II/dofs/dof_handler.h | 10 +++---
 include/deal.II/grid/tria.h        | 58 +++++++++---------------------
 2 files changed, 20 insertions(+), 48 deletions(-)

diff --git a/include/deal.II/dofs/dof_handler.h b/include/deal.II/dofs/dof_handler.h
index b08f751c97..a16ad141cc 100644
--- a/include/deal.II/dofs/dof_handler.h
+++ b/include/deal.II/dofs/dof_handler.h
@@ -891,9 +891,7 @@ public:
    * @name Cell iterator functions
    */
 
-  /*
-   * @{
-   */
+  /** @{ */
 
   /**
    * Iterator to the first used cell on level @p level.
@@ -962,11 +960,13 @@ public:
    */
   level_cell_iterator
   end_mg() const;
+  /** @} */
 
   /**
    * @name Cell iterator functions returning ranges of iterators
    */
 
+  /** @{ */
   /**
    * Return an iterator range that contains all cells (active or not) that
    * make up this DoFHandler. Such a range is useful to initialize range-based
@@ -1091,9 +1091,7 @@ public:
   IteratorRange<level_cell_iterator>
   mg_cell_iterators_on_level(const unsigned int level) const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
 
   /*---------------------------------------*/
diff --git a/include/deal.II/grid/tria.h b/include/deal.II/grid/tria.h
index c73d0600ce..74acd85179 100644
--- a/include/deal.II/grid/tria.h
+++ b/include/deal.II/grid/tria.h
@@ -2223,9 +2223,7 @@ public:
   virtual bool
   prepare_coarsening_and_refinement();
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Keeping up with what happens to a triangulation
@@ -2505,9 +2503,7 @@ public:
    */
   mutable Signals signals;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name History of a triangulation
@@ -2570,9 +2566,7 @@ public:
   bool
   get_anisotropic_refinement_flag() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name User data
@@ -2852,9 +2846,7 @@ public:
   void
   load_user_pointers_hex(const std::vector<void *> &v);
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Cell iterator functions
@@ -2991,9 +2983,11 @@ public:
    */
   cell_iterator
   create_cell_iterator(const CellId &cell_id) const;
+  /** @} */
 
   /**
    * @name Cell iterator functions returning ranges of iterators
+   * @{
    */
 
   /**
@@ -3083,9 +3077,7 @@ public:
   IteratorRange<active_cell_iterator>
   active_cell_iterators_on_level(const unsigned int level) const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /*-------------------------------------------------------------------------*/
 
@@ -3134,9 +3126,7 @@ public:
   IteratorRange<active_face_iterator>
   active_face_iterators() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /*-------------------------------------------------------------------------*/
 
@@ -3168,9 +3158,7 @@ public:
   vertex_iterator
   end_vertex() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Information about the triangulation
@@ -3447,9 +3435,7 @@ public:
   get_triangulation() const;
 
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Internal information about the number of objects
@@ -3542,9 +3528,7 @@ public:
   unsigned int
   n_raw_faces() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * Determine an estimate for the memory consumption (in bytes) of this
@@ -3997,9 +3981,7 @@ public:
     "coarsen flags on your triangulation via "
     "Triangulation::prepare_coarsening_and_refinement() beforehand!");
 
-  /*
-   * @}
-   */
+  /** @} */
 
 protected:
   /**
@@ -4119,9 +4101,7 @@ private:
   raw_cell_iterator
   end_raw(const unsigned int level) const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Line iterator functions for internal use
@@ -4184,9 +4164,7 @@ private:
   line_iterator
   end_line() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Quad iterator functions for internal use
@@ -4262,9 +4240,7 @@ private:
   quad_iterator
   end_quad() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
   /**
    * @name Hex iterator functions for internal use
@@ -4339,9 +4315,7 @@ private:
   hex_iterator
   end_hex() const;
 
-  /*
-   * @}
-   */
+  /** @} */
 
 
   /**
-- 
2.39.5