Update build and install instructions.

1 files changed, 49 insertions, 11 deletions

diff --git a/BUILD b/BUILD
index 74dd8a7..d8923a0 100644
--- a/BUILD
+++ b/BUILD
@@ -1,22 +1,60 @@
-This file documents build instructions.
+This file documents build and installation instructions.
 
-Building fontutils with GCC 4.5.2 doesn't require a seperate GCC installation 
+Building fontutils with GCC 4.5.x doesn't require a seperate GCC installation 
 but it is recommended that if you are using a GNU/Linux distribution with a 
 different version of GCC that you install a new version into a self-contained 
 directory. 
 
-After you have successfully installed a self-contained version of GCC 4.5.2 
-then try (substituting paths appropriately):
+You should also have bison, and development libraries of libxt, libxaw, and 
+kpathsea installed.
 
-autoconf
+After you have successfully installed the appropriate packages for your platform 
+then try the following steps (substituting paths appropriately):
 
-CC="/opt/gcc/install/bin/gcc" LD_LIBRARY_PATH="/opt/mpc/install/lib:/opt/mpfr/install/lib:/opt/gmp/install/lib" ./configure
+Step #1 - Create configure script:
 
-CC="/opt/gcc/install/bin/gcc" LD_LIBRARY_PATH="/opt/mpc/install/lib:/opt/mpfr/install/lib:/opt/gmp/install/lib" make
+    autoconf
 
-You might need to install the xt and xaw development libraries.  
-On Debian GNU/Linux:
+    NOTE: autoconf will generate the autom4te.cache directory and a configure script.
+          These are already present in .cvsignore so you do not need to worry about 
+          these being added to the source repository.
 
-apt-get install libxt-dev libxaw7-dev
 
-# one needs libkpathsea-dev temporarily until it is completely removed
+Step #2 - Configure your environment:
+
+    CC="/opt/gcc/install/bin/gcc" \ 
+    LD_LIBRARY_PATH="/opt/mpc/install/lib:/opt/mpfr/install/lib:/opt/gmp/install/lib" \
+    ./configure --prefix=/opt/fontutils/install
+
+    NOTE: The above command assumes you have a custom version of GCC installed as well as 
+          custom versions of mpc, mpfr and gmp. If you do not then you can simply execute 
+          the configure script. If you want to keep your source directory relatively clean 
+          then you should create a directory above the checked out source tree and run all 
+          of these steps from that directory and adjusting paths appropriately. 
+
+
+Step #3 - Build the binaries:
+
+    CC="/opt/gcc/install/bin/gcc" \
+    LD_LIBRARY_PATH="/opt/mpc/install/lib:/opt/mpfr/install/lib:/opt/gmp/install/lib" \
+    make
+
+    NOTE: You might need to install the xt, xaw, and kpathsea development libraries.  
+
+        If you are using Debian GNU/Linux you can use the following apt command:
+
+        apt-get install libxt-dev libxaw7-dev libkpathsea-dev
+
+
+        If you are using RHEL you can use the following yum command:
+
+        yum install libXt-devel libXaw-devel kpathsea-devel
+
+    NOTE: We only need kpathsea temporarily until it is completely removed.
+
+
+Step #4 - Install the binaries:
+
+    CC="/opt/gcc/install/bin/gcc" \
+    LD_LIBRARY_PATH="/opt/mpc/install/lib:/opt/mpfr/install/lib:/opt/gmp/install/lib" \
+    make install