This commit is contained in:
Ryan C. Gordon 2002-05-24 03:37:42 +00:00
parent 0ae1296332
commit 3f81a8413c
2 changed files with 35 additions and 40 deletions

View File

@ -2,10 +2,9 @@
* CHANGELOG. * CHANGELOG.
*/ */
05222002 - The internal zlib is now always built (but only linked in if 05222002 - Fixed the build system to always package the complete source, not
needed). This is so "make dist" includes the sources in the just what we built for a given system, when doing a "make dist".
tarball. I wonder if there's way to get them included without Updated INSTALL. Started writing BeOS platform code.
compiling them when they aren't needed.
05212002 - Cleaned up some FIXMEs. 05212002 - Cleaned up some FIXMEs.
05202002 - Added .cvsignore files. 05202002 - Added .cvsignore files.
05162002 - Edward Rudd also caught an embarrassing screwup by me in 05162002 - Edward Rudd also caught an embarrassing screwup by me in

68
INSTALL
View File

@ -1,11 +1,8 @@
------------------------------------------------------------------------------
NOTE: THESE INSTRUCTIONS NEED TO BE UPDATED FOR THE NEW BUILD SYSTEM. THIS -----------------------------------------------------------------------------
AFFECTS UNIX, WIN32 AND MACOS! Please note that the win32 and macos support files are out of date, but
will be corrected shortly. --ryan.
Please bitch to Ryan (icculus@clutteredmind.org) until he updates this. -----------------------------------------------------------------------------
------------------------------------------------------------------------------
@ -21,43 +18,42 @@ The best documentation for the PhysicsFS API is physfs.h. It is VERY heavily
commented, and makes an excellent, in-depth reference to all the functions. commented, and makes an excellent, in-depth reference to all the functions.
UNIX: UNIX and BeOS:
(If you got this code from CVS, run "./bootstrap" first.)
Edit "Makefile", and follow the instructions. The defaults are probably okay Run ./configure --help and see what features can be optionally enabled or
for general purposes, but give it a once over to make sure. If you don't have disabled. "./configure" does its best to pick optimal defaults for your
zLib on your system, you'll need to disable ZIP support. platform.
run "make" Run "make".
As root, run "make install".
That's it. The library will be sitting in a new directory called "bin". If you get sick of the library, run "make uninstall" as root and it will
remove all traces of the library from the system paths.
Run "make install" to install the library for use on your system.
WIN32: WIN32:
Download http://icculus.org/physfs/downloads/physfs-win32-support.zip, and If building with CygWin, follow the Unix instructions, above.
unpack in the root of the source directory, preserving directory names. If
you did it correctly, there should be a directory named "zlib114" in the Otherwise, get http://icculus.org/physfs/downloads/physfs-win32-support.zip,
same directory as "physfs.h". This archive has Visual C project files and and unpack in the root of the source directory, preserving directory names. If
the code needed for zipfile support in PhysicsFS, since most Windows boxes you did it correctly, there should be a file named "physfs.dsp" in the
don't have zlib preinstalled. same directory as "physfs.h". That zipfile has Visual C project files for
Visual Studio 6.0 and Visual Studio .NET. If you're using Visual C, point the
IDE at physfs.dsp, and build. If you're using any other compiler, send me a
patch when you get it working. :)
IMPORTANT: If you are using anything older than Visual Studio.NET, you IMPORTANT: If you are using anything older than Visual Studio.NET, you
will _NEED_ to upgrade to the latest Platform SDK from Microsoft. It is a will _NEED_ to upgrade to the latest Platform SDK from Microsoft. It is a
free download: http://www.microsoft.com/msdownload/platformsdk/sdkupdate/ free download: http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
Be sure to install _at least_ the Core SDK and the WMI SDK. I'm not sure if Be sure to install _at least_ the Core SDK and the WMI SDK. Even though you
this is needed (or usable for Cygwin). Even though you need these SDK updates, need these SDK updates, the compiled PhysicsFS DLL should work on any win32
the compiled PhysicsFS DLL should work on any win32 platform from Win95 and platform from Win95 and WinNT 4.0 and later. IF YOU ARE MISSING CONSTANTS
WinNT 4.0 and later. AND/OR THE PROJECT REFUSES TO LINK, YOUR PLATFORM SDK IS OUT OF DATE. Do _not_
complain to us. Suck it up and upgrade your libraries.
No one's tried building this for a WinCE (PocketPC) platform, but it may or No one's tried building this for a WinCE (PocketPC) platform, but it may or
may not work. Patches are welcome. may not work. Patches are welcome.
After that, if building with CygWin, follow the Unix instructions, above.
(Which used to work, see caveat about Platform SDK above). If you're using
Visual C, point the IDE at physfs.dsp, and build. If you're using any other
compiler, send me a patch when you get it working. :)
If someone is willing to maintain prebuilt PhysicsFS DLLs, I'd like to hear If someone is willing to maintain prebuilt PhysicsFS DLLs, I'd like to hear
from you; send an email to icculus@clutteredmind.org. from you; send an email to icculus@clutteredmind.org.
@ -65,17 +61,17 @@ from you; send an email to icculus@clutteredmind.org.
MACOS 8/9: MACOS 8/9:
Download http://icculus.org/physfs/downloads/mac_classic_support.sit and Download http://icculus.org/physfs/downloads/mac_classic_support.sit and
unpack it in the root of the physfs folder. It should produce a folder unpack it in the root of the physfs folder. It should produce a folder
called "Mac Classic Support" that has CodeWarrior 6 project files and a called "Mac Classic Support" that has CodeWarrior 6 project files.
copy of zlib for zipfile support.
If someone is willing to maintain prebuilt PhysicsFS Shared Libraries for If someone is willing to maintain prebuilt PhysicsFS Shared Libraries for
the Mac, I'd like to hear from you; send an email to icculus@clutteredmind.org. the Mac, I'd like to hear from you; send an email to icculus@clutteredmind.org.
OTHER PLATFORMS: OTHER PLATFORMS:
Many platforms might "just work" with the Unix Makefile (such as BeOS and Many platforms, such as Solaris and MacOS X, might "just work" with the Unix
MacOS X), but have not been heavily tested, if tested at all. To implement a autoconf tools. Some of these platforms are known to have worked at one time,
new platform or archiver, please read the heavily-commented physfs_internal.h but have not been heavily tested, if tested at all. To implement a new
platform or archiver, please read the heavily-commented physfs_internal.h
and look in the platform/ and archiver/ directories for examples. and look in the platform/ and archiver/ directories for examples.
--ryan. (icculus@clutteredmind.org) --ryan. (icculus@clutteredmind.org)