From 323031cff53186c3f5fb2f3ef86e755a2170d988 Mon Sep 17 00:00:00 2001
From: Markus Kauppila <markus.kauppila@gmail.com>
Date: Sat, 4 Jun 2011 18:08:54 +0300
Subject: [PATCH] Fixed old comments and added new ones.

---
 test/test-automation/SDL_test.c | 18 ++++++++++++++++++
 test/test-automation/runner.c   |  2 +-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/test/test-automation/SDL_test.c b/test/test-automation/SDL_test.c
index b410da4f1..ae5538f02 100644
--- a/test/test-automation/SDL_test.c
+++ b/test/test-automation/SDL_test.c
@@ -48,6 +48,7 @@ _TestCaseQuit()
 {
 	//! \todo make the test fail, if it does not contain any asserts
 	printf("Asserts: passed %d, failed %d\n", _testAssertsPassed, _testAssertsFailed);
+
 	if(_testAssertsFailed == 0 && _testAssertsPassed == 0) {
 		_testReturnValue = 2;
 	}
@@ -55,6 +56,15 @@ _TestCaseQuit()
 	return _testReturnValue;
 }
 
+
+/*!
+ *  Assert function. Tests if the expected value equals the actual value, then
+ *  the test assert succeeds, otherwise it fails and warns about it.
+ *
+ * \param expected Value user expects to have
+ * \param actual The actual value of tested variable
+ * \param message Message that will be printed if assert fails
+ */
 void
 AssertEquals(Uint32 expected, Uint32 actual, char* message, ...)
 {
@@ -73,6 +83,14 @@ AssertEquals(Uint32 expected, Uint32 actual, char* message, ...)
    }
 }
 
+/*!
+ *  Assert function. Tests if the given condition is true. True in
+ *  this case means non-zero value. If the condition is true, the
+ *  assert passes, otherwise it fails.
+ *
+ * \param condition Condition which will be evaluated
+ * \param message Message that will be printed if assert fails
+ */
 void
 AssertTrue(int condition, char *message, ...)
 {
diff --git a/test/test-automation/runner.c b/test/test-automation/runner.c
index 8d8aa0623..35ece189a 100644
--- a/test/test-automation/runner.c
+++ b/test/test-automation/runner.c
@@ -61,7 +61,7 @@ ScanForTestSuites() {
 /*!
  * Loads test suite which is implemented as dynamic library.
  *
- * \param test0,330
+ * \param testSuiteName Name of the test suite which will be loaded
  *
  * \return Pointer to loaded test suite, or NULL if library could not be loaded
  */