diff --git a/src/lib.rs b/src/lib.rs
index b84c662..1274a56 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -348,8 +348,9 @@ where
         }
     }
 
-    /// Open a directory. You can then read the directory entries in a random
-    /// order using `get_directory_entry`.
+    /// Open a directory.
+    ///
+    /// You can then read the directory entries with `iterate_dir` and `open_file_in_dir`.
     ///
     /// TODO: Work out how to prevent damage occuring to the file system while
     /// this directory handle is open. In particular, stop this directory
@@ -377,8 +378,9 @@ where
         })
     }
 
-    /// Open a directory. You can then read the directory entries in a random
-    /// order using `get_directory_entry`.
+    /// Open a directory.
+    ///
+    /// You can then read the directory entries with `iterate_dir` and `open_file_in_dir`.
     ///
     /// TODO: Work out how to prevent damage occuring to the file system while
     /// this directory handle is open. In particular, stop this directory