CAVEAT
 FontForge used to be called PfaEdit. Early releases may be found at
     http://fontforge.sf.net/

BEFORE INSTALLATION
 Before you install fontforge under Mac OS/X you should first install the X
 window system. This is available at:
	http://www.osxgnu.org/
 or
	http://www.apple.com/macosx/x11/download/

 It is possible to use fontforge without X, but in this case there is no user
 interface and you are limited to running scripts. (see below for details)

INSTALLATION NOTES:
    Download the appropriate binary from
        http://fontforge.sourceforge.net/MacOSX.html#binary
    There should be a mac package there which will do the installation for you.
    You may need to add /usr/local/bin to your PATH environment variable (and
    /usr/local/share/man to your MANPATH environment variable).
    If your shell is tcsh (or csh), edit ~/.cshrc and add:
        setenv PATH ${PATH}:/usr/local/bin
        if ( "$MANPATH" == "" ) then
            setenv MANPATH /usr/local/man
        else
            setenv MANPATH ${MANPATH}:/usr/local/share/man
        endif
    If your shell is bash then edit your ~/.bashrc and add
        PATH=${PATH}:/usr/local/bin   
        MANPATH=${MANPATH:-}:/usr/local/share/man ; export MANPATH
    At least one person also needed to define DYLD_LIBRARY_PATH to contain
    /usr/local/lib

BUILDING
    Just download the file fontforge_full-*.tgz which you will find on
        http://fontforge.sourceforge.net/index.html#source
    Move it somewhere appropriate (/usr/local/src perhaps?) and type:
        $ gunzip fontforge_full-*.tgz ; tar xf fontforge_full-*.tar
        $ cd fontforge
        $ configure
        $ make
        $ sudo -s
        # make install

If you want access to FontForge's type3 editing capabilities then
	$ configure --with-multilayer

More complex installations
    "make install" will also install a few other things which are not part of
    the standard package, but which are useful for some people.
    CIDMAPS:
        If you are going to be editing CID keyed fonts you should also down-
        load my cidmap files from
                http://fontforge.sourceforge.net/cidmaps.tgz
        put that file in the same place as you put fontforge_full*.tgz, then
            $ mkdir -p fontforge/cidmaps
            $ mv cidmaps.tgz fontforge/cidmaps
            $ cd fontforge/cidmaps
            $ gunzip *.tgz ; tar xf *.tar
            $ cd ../..
        And then proceed to do the normal install.
        Or install them manually:
            # mkdir -p /usr/local/share/fontforge
            # mv fontforge/cidmaps/* /usr/local/share/fontforge
    DOCUMENTATION:
        You can choose to install FontForge's documentation on your system, then
        pressing the [Help] or [F1] key within FontForge will go to the local
        docs rather than those on the web.
        Download the doc bundle from
            http://fontforge.sourceforge.net/index.html#docs
        Then (assuming you have not changed the install prefix)
            # mkdir -p /usr/local/share/doc/fontforge
            # mv fontforge_htdocs-*.tgz /usr/local/share/doc/fontforge
            # cd /usr/local/share/doc/fontforge
            # gunzip *.tgz; tar xf *.tar

DEPENDENCIES
 FontForge has more functionality if libpng and libungif are installed on your
 system. If they are not then you can find them at:
     http://www.libpng.org/pub/png/libpng.html
	 http://www.gzip.org/zlib/
     http://prtr-13.ucsc.edu/~badger/software/libungif/index.shtml

 FontForge also makes use of libuninameslist to be found at:
     http://libuninameslist.sf.net/

 FontForge's truetype debugger is completely dependent on:
     http://freetype.sf.net/
 The default configuration is useful to FontForge, but more functionality
 is obtained if you enable the bytecode interpreter (but note: you must
 have a license from Apple to do this). Instructions for doing so are
 in the file README.UNX in the freetype distribution.
 *** FontForge also needs to have the freetype sources available to it      ***
 *** when it builds (it needs some internal include files). The configure ***
 *** script can usually figure this out, but it is very time-consuming    ***
 *** you might want to say $ ./configure --with-freetype-src=<dir>	  ***
 *** where <dir> is the top-level freetype source directory		  ***

 Finally, if you want to do autotracing you should install
     http://sourceforge.net/projects/autotrace/
 or
     http://potrace.sf.net/

BUILDING without X11
    FontForge can be built without X11. You will probably only want to do this
    if your system lacks X (in which case configure should figure that out and
    do it automagically). But if, for some strange reason you wish to build a
    non-X version on a machine with X type:
        $ configure --without-x
    during the build process instead of "$ configure"      

RUNNING
 Before running FontForge you must start XDarwin. It lives in the Applications
 folder, and you start it by double clicking on it.
 You can start fontforge either from one of the xterms it creates, or from a 
 Terminal window. If you start from a Terminal window you must first type:
$ setenv DISPLAY :0

$ fontforge -new
 Creates a new font
$ fontforge -nosplash
 (No splash screen in case you have a very slow X connection)
$ fontforge font.pfa font2.pfb font3.ttf font4.otf font4.sfd
 Opens those fonts (sfd files are fontforge's own spline font database files)
$ fontforge
 Brings up a file picker dlg.
$ fontforge -script script-file [script arguments]
 Starts fontforge up without bringing up any windows. It will run the script-file
 (passing it any other arguments given on the command line) and then exit.

Either the Command (Apple, Cloverleaf) key or the Control key may be used for
invoking menu items (that is both ^Q and Cmd-Q will cause FontForge to quit).

CAVEATS
 1) FontForge does not conform to Apple's Human Interface Guidelines, and never
    will.
 2) The default window manager (twm) does not work well when 
    run 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
    mark the upper left corner of the window. Unfortunately if you click on
    top of an Aqua window (ie. anything that isn't X window) Aqua will put
    X into the background and the click will be lost to X.   

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

Please report any bugs to
        fontforge-devel@lists.sourceforge.net
(if you wish to send large testcases, example fonts, etc. please use
	fontforge-testcases@lists.sourceforge.net

DOCUMENTATION
        http://fontforge.sourceforge.net/overview.html

FONTS UNDER Mac OS/X
 Macintosh fonts live in /Library/Fonts, /System/Library/Fonts or
 ~/Library/Fonts. On Mac OS/X FontForge can edit .dfont and resource fork      
 fonts. On other systems FontForge can only edit Mac .dfonts (the concept
 of a resource fork is Mac specific).

 (X11 fonts on the mac are completely seperate from the mac fonts.       
 they reside somewhere in the X tree).

FONTS UNDER Mac OS/9
 Note Bene: As far as I know FontForge has not been ported to Mac OS/9 (or 8 or 7)

 Fonts live in :System Folder:Fonts: They are stored in resource forks, which
 means that if you want to work with them you must first wrap them up with 
 either macbinary or binhex (Fetch may be used to do either conversion as you
 transfer the font to a different system to edit it).

