# FontForge on Mac OS/X

## Building FontForge

Before you do anything you must get a copy of the Mac Developer Tools. These now ship with each new mac (on the CD labeled XCode), it is optional software, you must explicitly install it, or you can get this from Apple (you can either download a 250Meg file, or pay them $20 to FedEx you a CD.

Then you must install X11. Again it ships with new macs, again it must be explicitly installed. You need to install two X packages. The first is X11User on the third install CD, the second is X11SDK on the XCode CD.

It is possible to build FontForge without X11. There will be no user interface, but you can run scripts.

Thirdly you may choose to install some image libraries (I recommend at least installing libpng). Currently FontForge only tries to link statically with these libraries.

- libpng (and required helper zlib)
- libtiff
- libungif
- (see the dependencies entry for a more complete list)

Finally you are ready to build fontforge. Download the most recent sources from this site. then:

>     $ gunzip fontforge_full-*.tgz
>     $ tar xf fontforge_full-*.tar
>     $ cd fontforge
>     $ configure
>     $ make
>     $ sudo make install

## Installing the Mac OS/X binary distribution

Before installing FontForge you should ensure that you have X windows up and running. Apple now ships this with new Macs, but it is optional software (CD 3) and you must explicitly request it by customizing your install. You can also get this from apple, or from the GNU Mac OS/X site. (Or you can download the package built without X, which has no user interface but will let you run scripts).

After that you should just be able to unpack the packages provided in the File Release area.

These packages install into /usr/local/bin. You may need to add that to your PATH environment variable, and do something similar for MANPATH:

>     $ vi ~/.cshrc
>     setenv PATH /usr/local/bin:$PATH
>     setenv MANPATH /usr/local/share/man:$MANPATH

If your shell is bash

>     $ vi ~/.bashrc
>     PATH=/usr/local/bin:$PATH ; export PATH
>     MANPATH=/usr/local/share/man:$MANPATH ; export MANPATH

See the dependencies section for external libraries/programs you may want to add to your system to enhance FontForge's capabilities.

## Running FontForge on Mac OS/X

The X server (XDarwin) must be running before FontForge can start. XDarwin lives in the Applications folder and may be started by double clicking on it.

You may start FontForge either from an xterm or from a Terminal window. If you start it from a Terminal window you must first type:
$ setenv DISPLAY :0

The default window manager (twm) doesn't work well with FontForge when X is running in rootless mode.

FontForge allows the window manager to position its windows for it, and twm does this by allowing the user to click anywhere on the screen to position the upper left corner of the new window. Unfortunately unless X has a window under the location where you want the upper left corner to be Aqua will put X into the background and steal the click from X.

You can only open a window if you position it so that it's upper left corner is on one of X's already existing windows.

## Caveats for Mac OS/X

1. FontForge does not conform to Apple's Human Interface Guidelines

(Hexley the platypus, unofficial Darwin mascot, copyright Jon Hooper)