From 4e8ea36dc84b264bacd39b1c437b3413a15689e3 Mon Sep 17 00:00:00 2001
From: Jan Philipp Thiele <thiele@wias-berlin.de>
Date: Sat, 4 Nov 2023 00:09:37 +0100
Subject: [PATCH] Fix Triangulation copydocs

---
 .../distributed/fully_distributed_tria.h      | 11 +++++++-
 include/deal.II/distributed/tria_base.h       | 25 +++++++++++++++----
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/include/deal.II/distributed/fully_distributed_tria.h b/include/deal.II/distributed/fully_distributed_tria.h
index 6e302cf025..2b8598be91 100644
--- a/include/deal.II/distributed/fully_distributed_tria.h
+++ b/include/deal.II/distributed/fully_distributed_tria.h
@@ -134,7 +134,16 @@ namespace parallel
       virtual ~Triangulation() = default;
 
       /**
-       * @copydoc deal.II/grid/tria.h Triangulation::create_triangulation(const TriangulationDescription::Description<dim, spacedim>&)
+       * Create a triangulation from the provided
+       * TriangulationDescription::Description.
+       *
+       * @note Don't forget to attach the manifolds with set_manifold() before
+       *   calling this function if manifolds are needed.
+       *
+       * @note The namespace TriangulationDescription::Utilities contains functions
+       *   to create TriangulationDescription::Description.
+       *
+       * @param construction_data The data needed for this process.
        *
        * @note This is the function to be used instead of
        * Triangulation::create_triangulation() for some of the other
diff --git a/include/deal.II/distributed/tria_base.h b/include/deal.II/distributed/tria_base.h
index 998125325e..e32f80d32e 100644
--- a/include/deal.II/distributed/tria_base.h
+++ b/include/deal.II/distributed/tria_base.h
@@ -211,7 +211,16 @@ namespace parallel
       const unsigned int level) const override;
 
     /**
-     * @copydoc deal.II/grid/tria.h Triangulation::get_boundary_ids()
+     * Return a vector containing all boundary indicators assigned to boundary
+     * faces of active cells of this Triangulation object. Note, that each
+     * boundary indicator is reported only once. The size of the return vector
+     * will represent the number of different indicators (which is greater or
+     * equal one).
+     *
+     * @ingroup boundary
+     *
+     * @see
+     * @ref GlossBoundaryIndicator "Glossary entry on boundary indicators"
      *
      * @note This function involves a global communication gathering all current
      *   IDs from all processes.
@@ -220,7 +229,16 @@ namespace parallel
     get_boundary_ids() const override;
 
     /**
-     * @copydoc deal.II/grid/tria.h Triangulation::get_manifold_ids()
+     * Return a vector containing all manifold indicators assigned to the
+     * objects of the active cells of this Triangulation. Note, that each
+     * manifold indicator is reported only once. The size of the return vector
+     * will represent the number of different indicators (which is greater or
+     * equal one).
+     *
+     * @ingroup manifold
+     *
+     * @see
+     * @ref GlossManifoldIndicator "Glossary entry on manifold indicators"
      *
      * @note This function involves a global communication gathering all current
      *   IDs from all processes.
@@ -370,9 +388,6 @@ namespace parallel
     virtual void
     update_number_cache();
 
-    /**
-     * @copydoc deal.II/grid/tria.h Triangulation::update_reference_cells()
-     */
     void
     update_reference_cells() override;
 
-- 
2.39.5