add doxygen comment to cell::edges

The first two lines (brief) will shown in description
of the `struct cell`

The list will be shown in detailed description of cell::edges

diff --git a/lib/ortho/maze.h b/lib/ortho/maze.h
index ece0f2aa0281418dd983e18b9e320bf274bdf670..fe28381de806aa9e3b19174ffd1aec3433f77d90 100644 (file)
--- a/lib/ortho/maze.h
+++ b/lib/ortho/maze.h
@@ -34,7 +34,15 @@ enum {M_RIGHT=0, M_TOP, M_LEFT, M_BOTTOM};
 typedef struct cell {
   int flags;
   int nedges;
-  sedge* edges[6];
+  sedge* edges[6]; /**< @brief up to six links (@ref sedge) between
+                        four @ref sides (@ref snode) of the cell
+                            1. ┘ left — top
+                            2. └ top — right
+                            3. ┐ left — bottom
+                            4. ┌ bottom — right
+                            5. │ top — bottom
+                            6. ─ left — right
+                    */
   int nsides;
   snode** sides;
   boxf  bb;