diff --git a/docs/user/storage/Directory.dox b/docs/user/storage/Directory.dox
index bcca9c7352..e5b641b5ff 100644
--- a/docs/user/storage/Directory.dox
+++ b/docs/user/storage/Directory.dox
@@ -23,7 +23,7 @@
 	\class BDirectory
 	\ingroup storage
 	\ingroup libbe
-	\brief Represents a directory in the file system.
+	\brief A directory in the file system.
 */
 
 
@@ -250,17 +250,17 @@
 	\param traverse Whether or not to follow a symbolic link.
 
 	\returns A status code.
-	\retval B_OK: Everything went fine.
-	\retval B_BAD_VALUE: \c NULL \a path or \a entry.
-	\retval B_ENTRY_NOT_FOUND: Entry not found.
-	\retval B_PERMISSION_DENIED: Directory permissions didn't allow operation.
-	\retval B_NO_MEMORY: Insufficient memory for operation.
-	\retval B_NAME_TOO_LONG: The supplied path name (\a path) is too long.
-	\retval B_LINK_LIMIT: Indicates a cyclic loop within the file system.
-	\retval B_BUSY: A node was busy.
-	\retval B_FILE_ERROR: A general file error.
-	\retval B_NO_MORE_FDS: The application has run out of file descriptors.
-	\retval B_NOT_A_DIRECTORY: \a path includes a non-directory.
+	\retval B_OK Everything went fine.
+	\retval B_BAD_VALUE \c NULL \a path or \a entry.
+	\retval B_ENTRY_NOT_FOUND Entry not found.
+	\retval B_PERMISSION_DENIED Directory permissions didn't allow operation.
+	\retval B_NO_MEMORY Insufficient memory for operation.
+	\retval B_NAME_TOO_LONG The supplied path name (\a path) is too long.
+	\retval B_LINK_LIMIT Indicates a cyclic loop within the file system.
+	\retval B_BUSY A node was busy.
+	\retval B_FILE_ERROR A general file error.
+	\retval B_NO_MORE_FDS The application has run out of file descriptors.
+	\retval B_NOT_A_DIRECTORY \a path includes a non-directory.
 
 	\sa BEntry::SetTo(BDirectory *, const char *, bool)
 */
diff --git a/docs/user/storage/Entry.dox b/docs/user/storage/Entry.dox
index 18a5faf7eb..b9eafdb08d 100644
--- a/docs/user/storage/Entry.dox
+++ b/docs/user/storage/Entry.dox
@@ -241,8 +241,8 @@ BEntry entry("/boot/home/fido");
 	\brief Returns the result of the most recent construction or SetTo() call.
 
 	\returns A status code.
-	\retval \c B_OK Success
-	\retval \c B_NO_INIT The object has been Unset() or is uninitialized.
+	\retval B_OK Success
+	\retval B_NO_INIT The object has been Unset() or is uninitialized.
 */
 
 
@@ -378,7 +378,7 @@ if (err != B_ENTRY_NOT_FOUND)
 
 	\returns A status code.
 	\retval B_OK Success
-	\retval B_ENTRY_NOT_FOUND - Attempted to get the parent of the root
+	\retval B_ENTRY_NOT_FOUND Attempted to get the parent of the root
 		directory.
 */
 
@@ -394,7 +394,7 @@ if (err != B_ENTRY_NOT_FOUND)
 
 	\returns A status code.
 	\retval B_OK Success
-	\retval B_ENTRY_NOT_FOUND - Attempted to get the parent of the root
+	\retval B_ENTRY_NOT_FOUND Attempted to get the parent of the root
 		directory.
 */