Added more comments.

src/poker/turn.h

@@ -8,4 +8,11 @@
 #pragma once
 #include <dawn/dawn.h>
 
+/**
+ * Returns the AI result for a turn done by a non human player.
+ * 
+ * @param poker Poker game instance to use.
+ * @param playerIndex Player index to get the turn for.
+ * @return Some information about the move the player is trying to perform.
+ */
 pokerturn_t pokerTurnGet(poker_t *poker, uint8_t playerIndex);

src/ui/frame.h

@@ -11,12 +11,42 @@
 #include "../display/primitives/quad.h"
 #include "../display/gui/font.h"
 
+/**
+ * Initialize a GUI Frame.
+ * 
+ * @param frame Frame to initialize.
+ */
 void frameInit(frame_t *frame);
 
+/**
+ * Set the size of the frame (including the size of the border).
+ * 
+ * @param frame Frame to set the size of.
+ * @param width Width of the frame.
+ * @param height Height of the frame
+ */
 void frameSetSize(frame_t *frame, float width, float height);
 
+/**
+ * Set the size of the frame's innards (size excluding the borders).
+ * 
+ * @param frame Frame to set the size of
+ * @param width Width of the inner frame.
+ * @param height Height of the inner frame.
+ */
 void frameSetInnerSize(frame_t *frame, float width, float height);
 
+/**
+ * Render a game frame.
+ * 
+ * @param frame Frame to render.
+ * @param shader Shader to use while rendering.
+ */
 void frameRender(frame_t *frame, shader_t *shader);
 
+/**
+ * Cleanup a previously initialized frame.
+ * 
+ * @param frame Frame to dispose.
+ */
 void frameDispose(frame_t *frame);