From 71d88536b819982ca91e306e1f64d9f8742a6d9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mael=20Rouxel-Labb=C3=A9?=
 <mael.rouxel.labbe@geometryfactory.com>
Date: Thu, 26 Aug 2021 11:08:28 +0200
Subject: [PATCH] Fix doc

---
 Kernel_23/doc/Kernel_23/CGAL/Projection_traits_3.h | 14 ++++----------
 .../doc/Kernel_23/CGAL/Projection_traits_xy_3.h    |  1 +
 .../include/CGAL/internal/Projection_traits_3.h    |  2 ++
 3 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_3.h b/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_3.h
index aaeb6a4ad3b..36ee3865126 100644
--- a/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_3.h
+++ b/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_3.h
@@ -20,27 +20,20 @@ provides exact predicates.
 \cgalModels `ConstrainedTriangulationTraits_2`
 \cgalModels `PolygonTraits_2`
 
+\sa `CGAL::Projection_traits_xy_3`
+\sa `CGAL::Projection_traits_xz_3`
+\sa `CGAL::Projection_traits_yz_3`
 */
 template <class K>
 class Projection_traits_3
 {
 public:
-  ///\name Types
-  ///@{
-
-  //!
-  typedef typename K::Point_3     Point_2;
-
-  ///@}
-
-
   /// \name Functors
   /// The functors provided by this class are those listed in the
   /// concepts. The functors operate on the 2D projections of their
   /// arguments. They come with preconditions that projections of the
   /// arguments are non-degenerate, e.g. a line segment does not project
   /// on a single point, two points do not project onto the same point, etc.
-  ///@}
 
   /// \name Creation
   ///@{
@@ -54,4 +47,5 @@ public:
 
   ///@}
 };
+
 } // end namespace CGAL
diff --git a/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_xy_3.h b/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_xy_3.h
index b4979865d49..00ccfe4c298 100644
--- a/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_xy_3.h
+++ b/Kernel_23/doc/Kernel_23/CGAL/Projection_traits_xy_3.h
@@ -32,6 +32,7 @@ provides exact predicates.
 \cgalModels `ConvexHullTraits_2`
 \cgalModels `DelaunayMeshTraits_2`
 
+\sa `CGAL::Projection_traits_3`
 */
 template< typename K >
 class Projection_traits_xy_3 {
diff --git a/Kernel_23/include/CGAL/internal/Projection_traits_3.h b/Kernel_23/include/CGAL/internal/Projection_traits_3.h
index 0cb5624bc74..d8c230c546c 100644
--- a/Kernel_23/include/CGAL/internal/Projection_traits_3.h
+++ b/Kernel_23/include/CGAL/internal/Projection_traits_3.h
@@ -833,6 +833,8 @@ public:
   }
 };
 
+// This is for projection traits along a specific canonical plane (xy, yz, xz)
+// The generic class for an arbitrary normal is CGAL::Projection_traits_3<K> (not in `internal`)
 template < class R, int dim >
 class Projection_traits_3 {
 public: