From db2201e4e11860d23823fa83aff24b3ffd1fed04 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <icculus@icculus.org>
Date: Sat, 12 Aug 2017 02:21:11 -0400
Subject: [PATCH] Added some FIXMEs and deprecated PHYSFS_getLastError().

---
 src/physfs.h | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/physfs.h b/src/physfs.h
index 2863388c..97ab8bc0 100644
--- a/src/physfs.h
+++ b/src/physfs.h
@@ -4,6 +4,9 @@
  * Main header file for PhysicsFS.
  */
 
+// !!! FIXME-3.0: all the "you can get the error from getLastError()" should
+// !!! FIXME-3.0:  be updated for getLastErrorCode.
+
 /**
  * \mainpage PhysicsFS
  *
@@ -604,6 +607,8 @@ PHYSFS_DECL void PHYSFS_freeList(void *listVar);
  * \fn const char *PHYSFS_getLastError(void)
  * \brief Get human-readable error information.
  *
+ * \deprecated Use PHYSFS_getLastErrorCode() and PHYSFS_getErrorByCode() instead.
+ *
  * \warning As of PhysicsFS 2.1, this function has been nerfed.
  *          Before PhysicsFS 2.1, this function was the only way to get
  *          error details beyond a given function's basic return value.
@@ -648,7 +653,7 @@ PHYSFS_DECL void PHYSFS_freeList(void *listVar);
  * \sa PHYSFS_getLastErrorCode
  * \sa PHYSFS_getErrorByCode
  */
-PHYSFS_DECL const char *PHYSFS_getLastError(void);
+PHYSFS_DECL const char *PHYSFS_getLastError(void) PHYSFS_DEPRECATED;
 
 
 /**
@@ -958,7 +963,7 @@ PHYSFS_DECL char **PHYSFS_getSearchPath(void);
  *                         yourself.
  *
  *    \param archivesFirst Non-zero to prepend the archives to the search path.
- *                          Zero to append them. Ignored if !(archiveExt).
+ *                         Zero to append them. Ignored if !(archiveExt).
  *
  *  \return nonzero on success, zero on error. Specifics of the error can be
  *          gleaned from PHYSFS_getLastError().