Merge commit 'meins/master'
[paraslash.git] / user_list.c
index eebdfd7..0748ef6 100644 (file)
@@ -4,7 +4,7 @@
  * Licensed under the GPL v2. For licencing details see COPYING.
  */
 
  * Licensed under the GPL v2. For licencing details see COPYING.
  */
 
-/** \file user_list.c user handling for para_server */
+/** \file user_list.c User handling for para_server. */
 
 #include <sys/types.h>
 #include <dirent.h>
 
 #include <sys/types.h>
 #include <dirent.h>
@@ -85,12 +85,12 @@ err:
 }
 
 /**
 }
 
 /**
- * initialize the list of users allowed to connecto to para_server
+ * Initialize the list of users allowed to connect to to para_server.
  *
  *
- * \param user_list_file the file containing access information
+ * \param user_list_file The file containing access information.
  *
  *
- * If this function is called a second time, the contents of the
- * previous call are discarded.
+ * If this function is called for the second time, the contents of the
+ * previous call are discarded, i.e. the user list is reloaded.
  */
 void init_user_list(char *user_list_file)
 {
  */
 void init_user_list(char *user_list_file)
 {
@@ -111,12 +111,12 @@ void init_user_list(char *user_list_file)
 }
 
 /**
 }
 
 /**
- * lookup user in user_list.
+ * Lookup a user in the user list.
  *
  *
- * \param name of the user
+ * \param name The name of the user.
  *
  *
- * \return a pointer to the corresponding user struct if the user was found,
- *  \p NULL otherwise.
+ * \return A pointer to the corresponding user struct if the user was found, \p
+ * NULL otherwise.
  */
 struct user *lookup_user(const char *name)
 {
  */
 struct user *lookup_user(const char *name)
 {