Improved API documentation (copied from SFML)

include/SFML/System/Mutex.h

@@ -33,7 +33,7 @@
 
 
 ////////////////////////////////////////////////////////////
-/// Create a new mutex
+/// \brief Create a new mutex
 ///
 /// \return A new sfMutex object
 ///
@@ -41,25 +41,25 @@
 CSFML_API sfMutex* sfMutex_Create(void);
 
 ////////////////////////////////////////////////////////////
-/// Destroy an existing mutex
+/// \brief Destroy a mutex
 ///
-/// \param mutex : Mutex to delete
+/// \param mutex Mutex to destroy
 ///
 ////////////////////////////////////////////////////////////
 CSFML_API void sfMutex_Destroy(sfMutex* mutex);
 
 ////////////////////////////////////////////////////////////
-/// Lock a mutex
+/// \brief Lock a mutex
 ///
-/// \param mutex : Mutex to lock
+/// \param mutex Mutex object
 ///
 ////////////////////////////////////////////////////////////
 CSFML_API void sfMutex_Lock(sfMutex* mutex);
 
 ////////////////////////////////////////////////////////////
-/// Unlock a mutex
+/// \brief Unlock a mutex
 ///
-/// \param mutex : Mutex to unlock
+/// \param mutex Mutex object
 ///
 ////////////////////////////////////////////////////////////
 CSFML_API void sfMutex_Unlock(sfMutex* mutex);