From 2ae596eebaa801026f17ef128887c41ff75c6d66 Mon Sep 17 00:00:00 2001 From: Christian Heller Date: Wed, 21 Aug 2013 21:33:35 +0200 Subject: [PATCH 1/1] Improved formatting and comments for yx_uint16.h --- src/yx_uint16.h | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/src/yx_uint16.h b/src/yx_uint16.h index e5249b0..325b224 100644 --- a/src/yx_uint16.h +++ b/src/yx_uint16.h @@ -20,6 +20,8 @@ struct yx_uint16 uint16_t x; }; + + /* Directions available for movement. */ enum dir { @@ -29,10 +31,19 @@ enum dir WEST }; + + /* Return 1 if two yx_uint16 coordinates at "a" and "b" are equal, else 0. */ extern uint8_t yx_uint16_cmp(struct yx_uint16 * a, struct yx_uint16 * b); -/* Return yx_uint16 coordinate one step from coordinate yx in direction dir. */ + + +/* Return yx_uint16 coordinate one step from coordinate yx in direction dir. + * + * If an invalid dir "d" is passed, "yx" remains unchanged. + */ extern struct yx_uint16 mv_yx_in_dir(enum dir d, struct yx_uint16 yx); + + #endif -- 2.30.2