Skip to content

Commit

Permalink
Fixed some spelling and updated a few things.
Browse files Browse the repository at this point in the history
  • Loading branch information
macsforme committed Sep 28, 2015
1 parent a3e7e50 commit 438cd8a
Showing 1 changed file with 26 additions and 20 deletions.
46 changes: 26 additions & 20 deletions README.MacOSX
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
BZFlag README for Mac OS X
==========================

BZFlag is fully supported on Mac OS X. Included below are instructions on
installing BZFlag both from a binary and from a released source distribution.
BZFlag is supported on Mac OS X 10.7 and later. Included below are
instructions on installing BZFlag both from a binary and from a released
source distribution.

Binary Distribution
-------------------
Expand All @@ -14,7 +15,7 @@ distribution.
Once you've obtained a binary distribution of BZFlag, installation should be a
simple matter of copying the icon provided in the disk mounting image (the
.dmg) to your Applications folder. If you cannot run the client at all
(e.e. it starts to a black screen, or the icon bounces but then nothing
(i.e. it starts to a black screen, or the icon bounces but then nothing
happens), you can try several things:

1) Move or delete the BZFlag directory in your personal application support
Expand All @@ -32,27 +33,33 @@ happens), you can try several things:
should be listed there and will start with "BZFlag."

3) Run the binary directly by using Terminal:
/Applications/BZFlag-#.#.#.app/Contents/MacOS/BZFlag-#.#.#
/Applications/BZFlag-#.#.#.app/Contents/MacOS/BZFlag
(replace "#.#.#" with your actual BZFlag version number)

Source Distribution
-------------------

You can build BZFlag from source using Xcode version 4.2 and later. As of
BZFlag version 2.4.4, BZFlag has a fully native Xcode project
file. The earlier method of using the Xcode project file as a wrapper for
autotools is no longer supported. If you have a version of Xcode which
includes autotools, or have installed autotools yourself, you may additionally
be able to build using the traditional autotools method. See the README file
for further information. You will still need to install the SDL 2 framework as
detailed below.
You can build BZFlag from source using Xcode version 7 and later (You may also
be able to build with Xcode versions as early as 4.2, but you will need to
update the locations of libncurses, libcurl, and libz since those changed in
the Mac OS X 10.11 SDK). As of BZFlag version 2.4.4, BZFlag has a fully native
Xcode project file. The earlier method of using the Xcode project file as a
wrapper for autotools is no longer supported. If you have a version of Xcode
which includes autotools, or have installed autotools yourself, you may
additionally be able to build using the traditional autotools method. See the
README file for further information. You will still need to install the SDL 2
framework as detailed below.

BZFlag has two external dependencies: SDL 2 and c-ares.

Download the latest version of the SDL 2 framework from
https://www.libsdl.org/download-2.0.php. Version 2.0.4 or later is required.
Mount the disk image and place the file "SDL2.framework" in your
/Library/Frameworks directory (an administrator's account may be required).
As of the BZFlag 2.4.4 release, SDL 2.0.4 has not yet been released, but you
can build the latest development version of SDL 2 from Mercurial. If you
obtained a binary release of SDL 2, mount the disk image and place the file
"SDL2.framework" in your /Library/Frameworks directory (an administrator's
account may be required). If you built SDL 2 from source, locate the file
"SDL2.framework" and copy it into that same location.

This project expects the c-ares library and header files to be located in
/usr/local. If you install it elsewhere, you must update the library and
Expand All @@ -67,9 +74,8 @@ $ make
$ sudo make install

Obtain the latest BZFlag source archive from GitHub at
https://github.com/BZFlag-Dev/bzflag (you want the .tar.gz archive, NOT the
.zip archive). Once you have obtained the source code, open the
BZFlag.xcodeproj file located in the Xcode/ directory.
https://github.com/BZFlag-Dev/bzflag. Once you have obtained the source code,
open the BZFlag.xcodeproj file located in the Xcode/ directory.

The default behavior is to build a debug client. If you want a standard
client, click the "BZFlag" scheme button at the top left corner of the screen,
Expand Down Expand Up @@ -119,6 +125,6 @@ any system without issue.
To access the bzadmin text client or the bzflag server bzfs, right click the
application, click "Show Package Contents," and navigate to Contents/MacOS.
Server plugins are located at Contents/PlugIns. Note that while the plugin
names are different from Windows and Linux (something like "name.dylib"
instead of "name.dll or "name.so"), bzfs will still load them when you specify
the full plugin path.
names are different from Windows and Linux (something like "<name>.dylib"
instead of "<name>.dll or "<name>.so"), bzfs will still load them when you
specify the full plugin path.

0 comments on commit 438cd8a

Please sign in to comment.