Doc.

(This used to be commit b9ab79f30a931c694b1c181b1c2abd38186692ae)

1 files changed, 14 insertions, 9 deletions

diff --git a/source3/lib/messages.c b/source3/lib/messages.c
index 7ce050d70d..5974c5a872 100644
--- a/source3/lib/messages.c
+++ b/source3/lib/messages.c
@@ -457,13 +457,13 @@ BOOL message_send_all(TDB_CONTEXT *conn_tdb, int msg_type,
 	return True;
 }
 
-/** @} **/
-
+/**
+ * Lock the messaging tdb based on a string - this is used as a primitive
+ * form of mutex between smbd instances. 
+ *
+ * @param name A string identifying the name of the mutex.
+ */
 
-/*
-  lock the messaging tdb based on a string - this is used as a primitive form of mutex
-  between smbd instances. 
-*/
 BOOL message_named_mutex(const char *name)
 {
 	TDB_DATA key;
@@ -476,9 +476,12 @@ BOOL message_named_mutex(const char *name)
 	return (tdb_chainlock(tdb, key) == 0);
 }
 
-/*
-  unlock a named mutex
-*/
+/**
+ * Unlock a named mutex.
+ *
+ * @param name A string identifying the name of the mutex.
+ */
+
 void message_named_mutex_release(const char *name)
 {
 	TDB_DATA key;
@@ -488,3 +491,5 @@ void message_named_mutex_release(const char *name)
 
 	tdb_chainunlock(tdb, key);
 }
+
+/** @} **/