update comment

src/DotRecast.Detour/DtBVNode.cs

@@ -20,21 +20,13 @@ freely, subject to the following restrictions:
 
 namespace DotRecast.Detour
 {
-    /**
+    /// Bounding volume node.
- * Bounding volume node.
+    /// @note This structure is rarely if ever used by the end user.
- *
+    /// @see dtMeshTile
- * @note This structure is rarely if ever used by the end user.
- * @see MeshTile
- */
     public class DtBVNode
     {
-        /** Minimum bounds of the node's AABB. [(x, y, z)] */
+        public int[] bmin = new int[3]; //< Minimum bounds of the node's AABB. [(x, y, z)]
-        public int[] bmin = new int[3];
+        public int[] bmax = new int[3]; //< Maximum bounds of the node's AABB. [(x, y, z)]
-
+        public int i; //< The node's index. (Negative for escape sequence.)
-        /** Maximum bounds of the node's AABB. [(x, y, z)] */
-        public int[] bmax = new int[3];
-
-        /** The node's index. (Negative for escape sequence.) */
-        public int i;
     }
 }

src/DotRecast.Detour/DtLink.cs

@@ -20,30 +20,16 @@ freely, subject to the following restrictions:
 
 namespace DotRecast.Detour
 {
-    /**
+    /// Defines a link between polygons.
- * Defines a link between polygons.
+    /// @note This structure is rarely if ever used by the end user.
- *
+    /// @see dtMeshTile
- * @note This structure is rarely if ever used by the end user.
- * @see MeshTile
- */
     public class DtLink
     {
-        /** Neighbour reference. (The neighbor that is linked to.) */
+        public long refs; //< Neighbour reference. (The neighbor that is linked to.)
-        public long refs;
+        public int next; //< Index of the next link.
-
+        public int edge; //< Index of the polygon edge that owns this link.
-        /** Index of the next link. */
+        public int side; //< If a boundary link, defines on which side the link is.
-        public int next;
+        public int bmin; //< If a boundary link, defines the minimum sub-edge area.
-
+        public int bmax; //< If a boundary link, defines the maximum sub-edge area.
-        /** Index of the polygon edge that owns this link. */
-        public int edge;
-
-        /** If a boundary link, defines on which side the link is. */
-        public int side;
-
-        /** If a boundary link, defines the minimum sub-edge area. */
-        public int bmin;
-
-        /** If a boundary link, defines the maximum sub-edge area. */
-        public int bmax;
     }
 }

src/DotRecast.Detour/DtPolyDetail.cs

@@ -20,20 +20,13 @@ freely, subject to the following restrictions:
 
 namespace DotRecast.Detour
 {
-    /** Defines the location of detail sub-mesh data within a dtMeshTile. */
+    /// Defines the location of detail sub-mesh data within a dtMeshTile.
     public readonly struct DtPolyDetail
     {
-        /** The offset of the vertices in the MeshTile::detailVerts array. */
+        public readonly int vertBase; //< The offset of the vertices in the dtMeshTile::detailVerts array.
-        public readonly int vertBase;
+        public readonly int triBase; //< The offset of the triangles in the dtMeshTile::detailTris array.
-
+        public readonly int vertCount; //< The number of vertices in the sub-mesh.
-        /** The offset of the triangles in the MeshTile::detailTris array. */
+        public readonly int triCount; //< The number of triangles in the sub-mesh.
-        public readonly int triBase;
-
-        /** The number of vertices in the sub-mesh. */
-        public readonly int vertCount;
-
-        /** The number of triangles in the sub-mesh. */
-        public readonly int triCount;
 
         public DtPolyDetail(int vertBase, int triBase, int vertCount, int triCount)
         {