From f02560b1441456833b4506128423c074ac2d70bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Frank=20Grie=C3=9Fhammer?= <fgriessh@adobe.com>
Date: Mon, 24 Sep 2012 15:35:10 -0700
Subject: [PATCH] adding build instructions and shell script

---
 README.md | 46 +++++++++++++++++++++++++++++++++++++++++++---
 build.sh  | 13 +++++++++++++
 2 files changed, 56 insertions(+), 3 deletions(-)
 create mode 100755 build.sh

diff --git a/README.md b/README.md
index d9b96e5706..4e0a9473d4 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,51 @@
-#Source Code Pro
+Source Code Pro
+====
 
-##Overview
+Overview
+----
 Source Code Pro is a set of OpenType fonts that have been designed to work well
 in user interface (UI) environments. In addition to a functional OpenType font, this open
 source project provides all of the source files that were used to build this OpenType font
 by using the AFDKO makeotf tool.
 
-##Getting Involved
+Getting Involved
+----
 Send suggestions for changes to the Source Code OpenType font project maintainer,
 phunt@adobe.com, for consideration.
+
+
+Building
+====
+
+Pre-built font binaries
+----
+The font binaries are not part of the source files. They are provided in the [Downloads](https://github.com/adobe/Source-Code-Pro/downloads) section.
+
+
+Requirements
+----
+
+For building binary font files from source, installation of the [Adobe Font Development Kit for OpenType](http://www.adobe.com/devnet/opentype/afdko.html) (AFDKO) is necessary. The AFDKO tools are widely used for font development today, and are part of most font editor applications.
+
+Building one font
+----
+
+Key to building OTF or TTF fonts is `makeotf`, which is part of the AFDKO toolset.  
+Information and usage instructions can be found by executing `makeotf -h`.
+
+In this repository, all necessary files are in place for building the OTF and TTF fonts.  
+For example, build a binary OTF font for the Regular style like this:
+
+	$ cd Roman/Regular/
+    $ makeotf -r
+
+
+Building all fonts
+----
+
+For convenience, a shell script named `build.sh` is provided in the root directory.  
+It builds all OTFs and TTFs, and can be executed by typing:
+
+	$ ./build.sh
+
+
diff --git a/build.sh b/build.sh
new file mode 100755
index 0000000000..94a4b9237e
--- /dev/null
+++ b/build.sh
@@ -0,0 +1,13 @@
+#!/bin/sh
+
+# Build OTFs
+for f in $(find . -name 'font.pfa')
+do
+	makeotf -f $f -r
+done
+
+# Build TTFs
+for f in $(find . -name 'font.ttf')
+do
+	makeotf -f $f -gf GlyphOrderAndAliasDB_TT -newNameID4 -r
+done