Updated some documentation, added a FIXME.
authorRyan C. Gordon <icculus@icculus.org>
Sat, 28 Mar 2009 17:51:10 -0400
changeset 976 372a5232bc18
parent 975 653a53e51931
child 977 5a2f49a5f804
Updated some documentation, added a FIXME.
src/physfs.h
--- a/src/physfs.h	Sat Mar 28 17:50:54 2009 -0400
+++ b/src/physfs.h	Sat Mar 28 17:51:10 2009 -0400
@@ -2240,13 +2240,18 @@
  * PHYSFS_enumerateFilesCallback("/some/path", printDir, NULL);
  * \endcode
  *
+ * !!! FIXME: enumerateFiles() does not promise alphabetical sorting by
+ * !!! FIXME:  case-sensitivity in the code, and doesn't promise sorting at
+ * !!! FIXME:  all in the above docs.
+ *
  * Items sent to the callback are not guaranteed to be in any order whatsoever.
  *  There is no sorting done at this level, and if you need that, you should
  *  probably use PHYSFS_enumerateFiles() instead, which guarantees
  *  alphabetical sorting. This form reports whatever is discovered in each
  *  archive before moving on to the next. Even within one archive, we can't
  *  guarantee what order it will discover data. <em>Any sorting you find in
- *  these callbacks is just pure luck. Do not rely on it.</em>
+ *  these callbacks is just pure luck. Do not rely on it.</em> As this walks
+ *  the entire list of archives, you may receive duplicate filenames.
  *
  *    \param dir Directory, in platform-independent notation, to enumerate.
  *    \param c Callback function to notify about search path elements.