more syntax fixes

nx/include/switch/kernel/barrier.h

@@ -7,19 +7,19 @@
 #pragma once
 #include "semaphore.h"
 
-// barrier structure
+/// Barrier structure
-typedef struct Barrier{
+typedef struct Barrier {
-    u64 count;
+    u64 count; ///< Number of threads to reach the barrier
-    u64 thread_total;
+    u64 thread_total; ///< Number of threads to wait on
-    Semaphore throttle;
+    Semaphore throttle; ///< Semaphore to make sure threads release to scheduler one at a time
-    Semaphore lock;
+    Semaphore lock; ///< Semaphore to lock barrier to prevent multiple operations by threads at once
-    Semaphore thread_wait;
+    Semaphore thread_wait; ///< Semaphore to force a thread to wait if count < thread_total
 } Barrier;
 
 /**
  * @brief Initializes a barrier and the number of threads to wait on.
  * @param b Barrier object.
- * @param thread_count initial value for the number of threads the barrier must wait for.
+ * @param thread_count Initial value for the number of threads the barrier must wait for.
  */
 void barrierInit(Barrier *b, u64 thread_count);