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

BEFORE INSTALLATION
 To run fontforge under MS Windows you must first download the cygwin environment
 and probably the X windows package (of cygwin) as well.
 Look at
 	http://www.cygwin.com/
 and download the setup.exe program from there.
 run setup.exe
 it will ask you what components of cygwin you wish to install
 You will definitely need the base components, and you almost certainly want
  the X windowing system too.

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

INSTALLATION NOTES:
    Download the appropriate binary from
    	http://fontforge.sourceforge.net/index.html#binary
    If it is a .tgz file then it should contain
	A README file or two
	fontforge.exe  -- the executable
	fontforge.1    --	the man page.
	fontforge-*.ui --	various user interface string files for different
			languages
    You should:
	$ tar xfz fontforge_cygwin-*.tar
	$ mkdir -p /usr/local/bin /usr/local/man/man1 /usr/local/share/fontforge
	$ cd fontforge
	$ mv fontforge /usr/local/bin
	$ mv fontforge.1 /usr/local/man/man1
	$ mv *.ui /usr/local/share/fontforge

    You may need to add /usr/local/bin to your PATH environment variable (and
    /usr/local/man to your MANPATH environment variable)
    If your shell is bash then edit your ~/.bashrc and add
    	PATH=${PATH}:/usr/local/bin
	MANPATH=${MANPATH:-}:/usr/local/man ; export MANPATH

RUNNING
 Before running FontForge you must start X. Just start a cygwin shell and type
 	$ xinit
 in it. This will bring up a big window that convers the screen (this is X's
 root window) and a smaller window inside it (this is called an xterm).
 Move the mouse into that window and type
 	$ twm
 After this you can start fontforge...

$ 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.

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
	$ su
	# 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.
    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

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 is at:
	http://fontforge.sourceforge.net/index.html
