From c6e3707ab4ef1af6d9f199fcaa6bd688afe77d6c Mon Sep 17 00:00:00 2001
From: Sebastian Krzyszkowiak <dos@dosowisko.net>
Date: Sat, 19 May 2012 18:28:19 +0200
Subject: [PATCH] moar documentation

---
 src/allegro_utils.c |  3 +++
 src/allegro_utils.h |  3 +++
 src/main.h          |  1 +
 src/moonwalk.c      |  4 ++--
 src/moonwalk.h      |  6 +++---
 src/timeline.h      | 15 +++++++++++++++
 6 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/src/allegro_utils.c b/src/allegro_utils.c
index e2b3a5e..3af3588 100644
--- a/src/allegro_utils.c
+++ b/src/allegro_utils.c
@@ -1,3 +1,6 @@
+/*! \file allegro_utils.c
+ *  \brief Helper functions for Allegro.
+ */
 /*
  * Copyright (c) Sebastian Krzyszkowiak <dos@dosowisko.net>
  *
diff --git a/src/allegro_utils.h b/src/allegro_utils.h
index 6633048..83717b4 100644
--- a/src/allegro_utils.h
+++ b/src/allegro_utils.h
@@ -1,3 +1,6 @@
+/*! \file allegro_utils.h
+ *  \brief Headers of helper functions for Allegro.
+ */
 /*
  * Copyright (c) Sebastian Krzyszkowiak <dos@dosowisko.net>
  *
diff --git a/src/main.h b/src/main.h
index f6c4732..e7bd575 100644
--- a/src/main.h
+++ b/src/main.h
@@ -74,6 +74,7 @@ struct Obstacle {
 	struct Obstacle *next; /*!< Next obstacle on the list. */
 };
 
+/*! \brief Structure representing one spritesheet animation of Derpy. */
 struct Spritesheet {
 	char* name; /*!< Readable name of the spritesheet. */
 	ALLEGRO_BITMAP* bitmap; /*!< Spritesheet bitmap. */
diff --git a/src/moonwalk.c b/src/moonwalk.c
index 1f752de..09befcd 100644
--- a/src/moonwalk.c
+++ b/src/moonwalk.c
@@ -1,5 +1,5 @@
-/*! \file level.c
- *  \brief Playable Level code.
+/*! \file moonwalk.c
+ *  \brief Moonwalk Level placeholder code.
  */
 /*
  * Copyright (c) Sebastian Krzyszkowiak <dos@dosowisko.net>
diff --git a/src/moonwalk.h b/src/moonwalk.h
index ca3d1ac..3f91a15 100644
--- a/src/moonwalk.h
+++ b/src/moonwalk.h
@@ -1,5 +1,5 @@
-/*! \file level.h
- *  \brief Playable Level headers.
+/*! \file moonwalk.h
+ *  \brief Moonwalk Level placeholder headers.
  */
 /*
  * Copyright (c) Sebastian Krzyszkowiak <dos@dosowisko.net>
@@ -26,4 +26,4 @@ void Moonwalk_Unload(struct Game *game);
 void Moonwalk_Load(struct Game *game);
 int Moonwalk_Keydown(struct Game *game, ALLEGRO_EVENT *ev);
 void Moonwalk_UnloadBitmaps(struct Game *game);
-void Moonwalk_PreloadBitmaps(struct Game *game);
\ No newline at end of file
+void Moonwalk_PreloadBitmaps(struct Game *game);
diff --git a/src/timeline.h b/src/timeline.h
index 492a2b7..adb6137 100644
--- a/src/timeline.h
+++ b/src/timeline.h
@@ -21,17 +21,20 @@
 
 #include "main.h"
 
+/*! \brief State of the TM_Action. */
 enum TM_ActionState {
 	TM_ACTIONSTATE_INIT,
 	TM_ACTIONSTATE_RUNNING,
 	TM_ACTIONSTATE_DESTROY
 };
 
+/*! \brief Arguments for TM_Action. */
 struct TM_Arguments {
 	void *value;
 	struct TM_Arguments *next;
 };
 
+/*! \brief Timeline action. */
 struct TM_Action {
 	bool (*function)(struct Game*, struct TM_Action*, enum TM_ActionState);
 	struct TM_Arguments *arguments;
@@ -43,15 +46,27 @@ struct TM_Action {
 	char* name;
 };
 
+/*! \brief Init timeline. */
 void TM_Init(struct Game* game);
+/*! \brief Process current timeline actions. */
 void TM_Process();
+/*! \brief Handle timer events. */
 void TM_HandleEvent(ALLEGRO_EVENT *ev);
+/*! \brief Add new action to main queue. */
 struct TM_Action* TM_AddAction(bool (*func)(struct Game*, struct TM_Action*, enum TM_ActionState), struct TM_Arguments* args, char* name);
+/*! \brief Add new action to background queue. */
 struct TM_Action* TM_AddBackgroundAction(bool (*func)(struct Game*, struct TM_Action*, enum TM_ActionState), struct TM_Arguments* args, float delay, char* name);
+/*! \brief Add new action to main queue, which adds specified action into background queue. */
 struct TM_Action* TM_AddQueuedBackgroundAction(bool (*func)(struct Game*, struct TM_Action*, enum TM_ActionState), struct TM_Arguments* args, float delay, char* name);
+/*! \brief Add delay to main queue. */
 void TM_AddDelay(float delay);
+/*! \brief Pause timers. */
 void TM_Pause(bool pause);
+/*! \brief Destroy timeline. */
 void TM_Destroy();
+/*! \brief Add data to TM_Arguments queue. */
 struct TM_Arguments* TM_AddToArgs(struct TM_Arguments* args, void* arg);
+/*! \brief Destroy TM_Arguments queue. */
 void TM_DestroyArgs(struct TM_Arguments* args);
+/*! \brief Check if timeline is initialised. */
 bool TM_Initialized();