Resolve Doxygen errors from RTOS. Fixed minor Doxygen bug in FileSystemHandle.h as well

Author: kegilbert

doxyfile_options

@@ -840,6 +840,7 @@ EXCLUDE_PATTERNS       = */tools/* \
                          */TESTS/* \
                          */targets/* \
                          */BUILD/* \
+                         */rtos/rtx* \
                          */events/* \
                          */cmsis/* \
                          */hal/* \

rtos/MemoryPool.h

@@ -76,8 +76,8 @@ class MemoryPool {
     }
 
     /** Free a memory block.
-      @param   address of the allocated memory block to be freed.
-      @return  status code that indicates the execution status of the function.
+      @param   block  address of the allocated memory block to be freed.
+      @return         status code that indicates the execution status of the function.
     */
     osStatus free(T *block) {
         return osMemoryPoolFree(_id, (void*)block);

rtos/Semaphore.h

@@ -40,7 +40,7 @@ namespace rtos {
 class Semaphore {
 public:
     /** Create and Initialize a Semaphore object used for managing resources.
-      @param number of available resources; maximum index value is (count-1). (default: 0).
+      @param count      number of available resources; maximum index value is (count-1). (default: 0).
     */
     Semaphore(int32_t count=0);
 

rtos/Thread.h

@@ -85,7 +85,6 @@ class Thread {
 
     /** Create a new thread, and start it executing the specified function.
       @param   task           function to be executed by this thread.
-      @param   argument       pointer that is passed to the thread function as start argument. (default: NULL).
       @param   priority       initial priority of the thread function. (default: osPriorityNormal).
       @param   stack_size     stack size (in bytes) requirements for the thread function. (default: OS_STACK_SIZE).
       @param   stack_mem      pointer to the stack area to be used by this thread (default: NULL).
@@ -112,9 +111,8 @@ class Thread {
     }
 
     /** Create a new thread, and start it executing the specified function.
-      @param   obj            argument to task.
-      @param   method         function to be executed by this thread.
       @param   argument       pointer that is passed to the thread function as start argument. (default: NULL).
+      @param   task           argument to task.
       @param   priority       initial priority of the thread function. (default: osPriorityNormal).
       @param   stack_size     stack size (in bytes) requirements for the thread function. (default: OS_STACK_SIZE).
       @param   stack_mem      pointer to the stack area to be used by this thread (default: NULL).
@@ -143,9 +141,8 @@ class Thread {
     }
 
     /** Create a new thread, and start it executing the specified function.
-      @param   obj            argument to task.
-      @param   method         function to be executed by this thread.
       @param   argument       pointer that is passed to the thread function as start argument. (default: NULL).
+      @param   task           argument to task.
       @param   priority       initial priority of the thread function. (default: osPriorityNormal).
       @param   stack_size     stack size (in bytes) requirements for the thread function. (default: OS_STACK_SIZE).
       @param   stack_mem      pointer to the stack area to be used by this thread (default: NULL).