Index: uspace/lib/posix/pwd.c
===================================================================
--- uspace/lib/posix/pwd.c	(revision 3f33b953b365d91867e9c67e1e93d07978976bb1)
+++ uspace/lib/posix/pwd.c	(revision 3190e88f9acc9542b60dfabd34fed444e2548d21)
@@ -51,8 +51,11 @@
 
 /**
+ * Retrieve next broken-down entry from the user database.
+ *
  * Since HelenOS doesn't have user accounts, this always returns
  * the same made-up entry.
  *
- * @return
+ * @return Next user database entry or NULL if not possible. Since HelenOS
+ *     doesn't have user accounts, this always returns the same made-up entry.
  */
 struct posix_passwd *posix_getpwent(void)
@@ -67,5 +70,5 @@
 
 /**
- * "Rewind the user list".
+ * Rewind the user list.
  */
 void posix_setpwent(void)
@@ -86,5 +89,5 @@
  *
  * @param name Name of the entry.
- * @return
+ * @return Either found entry or NULL if no such entry exists.
  */
 struct posix_passwd *posix_getpwnam(const char *name)
@@ -103,9 +106,10 @@
  *
  * @param name Name of the entry.
- * @param pwd
- * @param buffer
- * @param bufsize
- * @param result
- * @return
+ * @param pwd Original structure.
+ * @param buffer Buffer for the strings referenced from the result structure.
+ * @param bufsize Length of the buffer.
+ * @param result Where to store updated structure.
+ * @return Zero on success (either found or not found, but without an error),
+ *     non-zero error number if error occured.
  */
 int posix_getpwnam_r(const char *name, struct posix_passwd *pwd,
@@ -129,5 +133,5 @@
  *
  * @param uid UID of the entry.
- * @return
+ * @return Either found entry or NULL if no such entry exists.
  */
 struct posix_passwd *posix_getpwuid(posix_uid_t uid)
@@ -144,9 +148,10 @@
  *
  * @param uid UID of the entry.
- * @param pwd
- * @param buffer
- * @param bufsize
- * @param result
- * @return
+ * @param pwd Original structure.
+ * @param buffer Buffer for the strings referenced from the result structure.
+ * @param bufsize Length of the buffer.
+ * @param result Where to store updated structure.
+ * @return Zero on success (either found or not found, but without an error),
+ *     non-zero error number if error occured.
  */
 int posix_getpwuid_r(posix_uid_t uid, struct posix_passwd *pwd,