Fixed the doxygen markup.
authorMarkus Kauppila <markus.kauppila@gmail.com>
Thu, 11 Aug 2011 22:26:33 +0300
changeset 5826 ac41301850c1
parent 5825 9dd4fa61d5cc
child 5827 ef0942587b80
Fixed the doxygen markup.
test/test-automation/src/libSDLtest/fuzzer/fuzzer.c
test/test-automation/src/libSDLtest/fuzzer/fuzzer.h
test/test-automation/src/libSDLtest/plain_logger.h
test/test-automation/src/libSDLtest/xml_logger.h
test/test-automation/src/runner/runner.c
test/test-automation/tests/testrwops/testrwops.c
--- a/test/test-automation/src/libSDLtest/fuzzer/fuzzer.c	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/src/libSDLtest/fuzzer/fuzzer.c	Thu Aug 11 22:26:33 2011 +0300
@@ -217,7 +217,6 @@
  * \param validDomain Generate only for valid domain (for the data type)
  *
  * \param outBuffer The generated boundary values are put here
- * \param outBufferSize Size of outBuffer
  *
  * \returns Returns the number of elements in outBuffer or -1 in case of error
  */
@@ -382,7 +381,11 @@
  * If boundary1 == boundary2, value of boundary1 will be returned
  *
  * Generating boundary values for Sint8:
- * <Add examples>
+ * SignedBoundaryValues(sizeof(Sint8), -10, 20, True) -> [-11,-10,19,20]
+ * SignedBoundaryValues(sizeof(Sint8), -10, 20, False) -> [-11,21]
+ * SignedBoundaryValues(sizeof(Sint8), -30, -15, True) -> [-30, -29, -16, -15]
+ * SignedBoundaryValues(sizeof(Sint8), -128, 15, False) -> [16]
+ * SignedBoundaryValues(sizeof(Sint8), -128, 127, False) -> NULL
  *
  * Generator works the same for other types of signed integers.
  *
@@ -390,7 +393,7 @@
  * If outbuffer != NULL, it'll be freed.
  *
  *
- * \paran minValue The smallest value  that is acceptable for this data type.
+ * \param minValue The smallest value  that is acceptable for this data type.
  *					For instance, for Uint8 -> -128, Uint16 -> -32,768 etc.
  * \param maxValue The biggest value that is acceptable for this data type.
  * 					For instance, for Uint8 -> 127, Uint16 -> 32767 etc.
@@ -399,7 +402,6 @@
  * \param validDomain Generate only for valid domain (for the data type)
  *
  * \param outBuffer The generated boundary values are put here
- * \param outBufferSize Size of outBuffer
  *
  * \returns Returns the number of elements in outBuffer or -1 in case of error
  */
--- a/test/test-automation/src/libSDLtest/fuzzer/fuzzer.h	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/src/libSDLtest/fuzzer/fuzzer.h	Thu Aug 11 22:26:33 2011 +0300
@@ -322,12 +322,12 @@
  * \param runSeed Seed of the harness
  * \param suiteName Test suite name
  * \param testName Test name
- * \param iteration Number of test iteration
+ * \param iterationNumber of test iteration
  *
  * \return Generated execution key as blob of 16 bytes. It needs be deallocated.
  * 			On error, returns NULL.
  */
-Uint64 GenerateExecKey(char *runSeed, char *suiteName, char *testName, int interationNumber);
+Uint64 GenerateExecKey(char *runSeed, char *suiteName, char *testName, int iterationNumber);
 
 
 #endif
--- a/test/test-automation/src/libSDLtest/plain_logger.h	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/src/libSDLtest/plain_logger.h	Thu Aug 11 22:26:33 2011 +0300
@@ -32,7 +32,7 @@
  * \param runnerParameters What parameters were given to the runner
  * \param runSeed Fuzzer seed of the harness
  * \param eventTime When the execution started
- * \param loggerData LoggerData structure which contains data for the logger
+ * \param data LoggerData structure which contains data for the logger
  *
  */
 void PlainRunStarted(int parameterCount, char *runnerParameters[], char *runSeed,
@@ -134,8 +134,8 @@
 /*!
  * Prints given message
  *
- * \param logMessage Message to be logged
  * \param eventTime Timestamp for log message
+ * \param fmt Message to be logged
  */
 void PlainLog(time_t eventTime, char *fmt, ...);
 
--- a/test/test-automation/src/libSDLtest/xml_logger.h	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/src/libSDLtest/xml_logger.h	Thu Aug 11 22:26:33 2011 +0300
@@ -32,7 +32,7 @@
  * \param runnerParameters What parameters were given to the runner
  * \param runSeed Fuzzer seed of the harness
  * \param eventTime When the execution started
- * \param loggerData LoggerData structure which contains data for the logger
+ * \param data LoggerData structure which contains data for the logger
  */
 void XMLRunStarted(int parameterCount, char *runnerParameters[], char *runSeed,
 					time_t eventTime, LoggerData *data);
@@ -132,8 +132,8 @@
 /*!
  * Prints given message in XML
  *
- * \param logMessage Message to be logged
  * \param eventTime Timestamp for log message
+ * \param fmt Message to be logged
  */
 void XMLLog(time_t eventTime, char *fmt, ...);
 
--- a/test/test-automation/src/runner/runner.c	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/src/runner/runner.c	Thu Aug 11 22:26:33 2011 +0300
@@ -824,6 +824,8 @@
  * be executed in-proc or out-of-proc.
  *
  * \param testItem The test case that will be executed
+ * \param execKey Execution key for the test case
+ *
  * \return The return value of the test. Zero means success, non-zero failure.
  */
 int
--- a/test/test-automation/tests/testrwops/testrwops.c	Thu Aug 11 22:07:14 2011 +0300
+++ b/test/test-automation/tests/testrwops/testrwops.c	Thu Aug 11 22:26:33 2011 +0300
@@ -123,15 +123,6 @@
 
 
 /**
- * @brief Does a generic rwops test.
- *
- * RWops should have "Hello World!" in it already if write is disabled.
- *
- *    @param write Test writing also.
- *    @return 1 if an assert is failed.
- */
-
-/**
  * @brief Tests opening from memory.
  *
  * \sa http://wiki.libsdl.org/moin.cgi/SDL_RWFromMem