From 0e628a7cf4a23fd2a1d51624ffa56e9bd0378943 Mon Sep 17 00:00:00 2001
From: Markus Kauppila <markus.kauppila@gmail.com>
Date: Mon, 30 May 2011 18:58:20 +0300
Subject: [PATCH] Fixed doxygen warnings

---
 test/test-automation/runner.c | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/test/test-automation/runner.c b/test/test-automation/runner.c
index c96d901c6..1bb66a0e4 100644
--- a/test/test-automation/runner.c
+++ b/test/test-automation/runner.c
@@ -35,7 +35,9 @@ typedef int (*TestCase)(void *arg);
  *
  * \return Loaded test suite
  */
-void *LoadTestSuite() {
+void *
+LoadTestSuite()
+{
 #if defined(linux) || defined( __linux)
 	char *libName = "tests/libtest.so";
 #else
@@ -57,7 +59,9 @@ void *LoadTestSuite() {
  * \param library Previously loaded dynamic library AKA test suite
  * \return Loaded TestCaseReferences
  */
-TestCaseReference **QueryTestCases(void *library) {
+TestCaseReference **
+QueryTestCases(void *library)
+{
 	TestCaseReference **(*suite)(void);
 
 	suite = (TestCaseReference **(*)(void)) SDL_LoadFunction(library, "QueryTestSuite");
@@ -78,12 +82,14 @@ TestCaseReference **QueryTestCases(void *library) {
 /*!
  * Loads test case from a test suite
  *
- * \param Test suite
- * \testName Name of the test that is going to be loaded
+ * \param suite a test suite
+ * \param testName Name of the test that is going to be loaded
  *
  * \return loaded test
  */
-TestCase LoadTestCase(void *suite, char *testName) {
+TestCase
+LoadTestCase(void *suite, char *testName)
+{
 	TestCase test = (int (*)(void *)) SDL_LoadFunction(suite, testName);
 	if(test == NULL) {
 		printf("Loading test failed, tests == NULL\n");
@@ -94,7 +100,6 @@ TestCase LoadTestCase(void *suite, char *testName) {
 }
 
 
-
 /*!
  * If using out-of-proc execution of tests. This function
  * will handle the return value of the child process
@@ -105,8 +110,10 @@ TestCase LoadTestCase(void *suite, char *testName) {
  *
  * \return 0 if test case succeeded, 1 otherwise
  */
-int HandleTestReturnValue(int stat_lock) {
-	//! \todo rename to: HandleChildReturn Value
+int
+HandleTestReturnValue(int stat_lock)
+{
+	//! \todo rename to: HandleChildProcessReturnValue?
 	int returnValue = -1;
 
 	if(WIFEXITED(stat_lock)) {
@@ -122,7 +129,7 @@ int HandleTestReturnValue(int stat_lock) {
 }
 
 //!< Flag for executing tests in-process
-int execute_inproc = 0;
+static int execute_inproc = 0;
 
 /*!
  * Parse command line arguments
@@ -145,7 +152,7 @@ main(int argc, char *argv[])
 {
 	ParseOptions(argc, argv);
 
-	// print: Testing againts SDL version fuu (rev: bar) if verbose == true
+	// print: Testing against SDL version fuu (rev: bar) if verbose == true
 
 	int failureCount = 0, passCount = 0;