From f910579e66a1495c4c1c97e2b99ea178d9d194ee Mon Sep 17 00:00:00 2001
From: pacien
Date: Sat, 9 Dec 2017 01:59:50 +0100
Subject: Add proper struct documentation

Signed-off-by: pacien <pacien.trangirard@pacien.net>
---
 include/common/geom.h | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

(limited to 'include/common/geom.h')

diff --git a/include/common/geom.h b/include/common/geom.h
index 4445998..a843c76 100644
--- a/include/common/geom.h
+++ b/include/common/geom.h
@@ -15,16 +15,24 @@
 typedef int32_t IntVector;
 
 /**
- * Type: CartesianVector
+ * Struct: CartesianVector
  * An abstract 2-D vector in cartesian coordinates.
+ *
+ * Fields:
+ *   x - the horizontal component
+ *   y - the vertical component
  */
 typedef struct {
   IntVector x, y;
 } CartesianVector;
 
 /**
- * Type: CartesianMapping
+ * Struct: CartesianMapping
  * A tuple of cartesian vectors representing a mapping.
+ *
+ * Fields:
+ *   origin - preimage vector
+ *   target - image vector
  */
 typedef struct {
   CartesianVector origin, target;
-- 
cgit v1.2.3