          MODULE=physfs
         VERSION=3.2.0
          SOURCE=$MODULE-$VERSION.tar.gz
 SOURCE_URL_FULL=https://github.com/icculus/physfs/archive/refs/tags/release-$VERSION.tar.gz
      SOURCE_VFY=sha256:1991500eaeb8d5325e3a8361847ff3bf8e03ec89252b7915e1f25b3f8ab5d560
SOURCE_DIRECTORY=$BUILD_DIRECTORY/$MODULE-release-$VERSION
        WEB_SITE=https://icculus.org/physfs/
         ENTERED=20030215
         UPDATED=20260609
           SHORT="library providing abstract access to various archives"

cat << EOF
PhysicsFS is a library to provide abstract access to various archives. It
is intended for use in video games, and the design was somewhat inspired by
Quake 3's file subsystem. The programmer defines a "write directory" on the
physical filesystem. No file writing done through the PhysicsFS API can
leave that write directory, for security. For example, an embedded scripting
language cannot write outside of this path if it uses PhysFS for all of its
I/O, which means that untrusted scripts can run more safely. Symbolic links
can be disabled as well, for added safety. For file reading, the programmer
lists directories and archives that form a "search path". Once the search
path is defined, it becomes a single, transparent hierarchical filesystem.
This makes for easy access to ZIP files in the same way as you access a file
directly on the disk, and it makes it easy to ship a new archive that will
override a previous archive on a per-file basis. Finally, PhysicsFS gives
you platform-abstracted means to determine if CD-ROMs are available, the
user's home directory, where in the real filesystem your program is running.
EOF
