Fixed a FIXME in the documentation comments.

This commit is contained in:
Ryan C. Gordon 2007-03-20 17:53:42 +00:00
parent 75e467576d
commit 7703202ee5
1 changed files with 12 additions and 12 deletions

View File

@ -1948,18 +1948,18 @@ typedef struct
* (This is for limited, hardcore use. If you don't immediately see a need * (This is for limited, hardcore use. If you don't immediately see a need
* for it, you can probably ignore this forever.) * for it, you can probably ignore this forever.)
* *
* !!! FIXME: don't promise C runtime malloc. * By default, PhysicsFS will use whatever is reasonable for a platform
* * to manage dynamic memory (usually ANSI C malloc/realloc/calloc/free, but
* By default, PhysicsFS will use ANSI C malloc/realloc/calloc/free calls * some platforms might use something else), but in some uncommon cases, the
* to manage dynamic memory, but in some uncommon cases, the app might want * app might want more control over the library's memory management. This
* more control over the library's memory management. This lets you redirect * lets you redirect PhysicsFS to use your own allocation routines instead.
* physfs to use your own allocation routines instead. You can only call this * You can only call this function before PHYSFS_init(); if the library is
* function before PHYSFS_init(); if the library is initialized, it'll * initialized, it'll reject your efforts to change the allocator mid-stream.
* reject your efforts to change the allocator mid-stream. You may call this * You may call this function after PHYSFS_deinit() if you are willing to
* function after PHYSFS_deinit() if you are willing to shutdown the library * shut down the library and restart it with a new allocator; this is a safe
* and restart it with a new allocator; this is a safe and supported * and supported operation. The allocator remains intact between deinit/init
* operation. The allocator remains intact between deinit/init calls. * calls. If you want to return to the platform's default allocator, pass a
* If you want to return to the default allocator, pass a NULL in here. * NULL in here.
* *
* If you aren't immediately sure what to do with this function, you can * If you aren't immediately sure what to do with this function, you can
* safely ignore it altogether. * safely ignore it altogether.