Move readme to markdown syntax
This way it looks a bit nicer on Github. Adds an extra top level heading
explaining the OpenPower firmware.
Signed-off-by: Joel Stanley <joel@jms.id.au>
diff --git a/README b/README
deleted file mode 100644
index a1b969d..0000000
--- a/README
+++ /dev/null
@@ -1,29 +0,0 @@
-=== Building an image ===
-
-git clone --recursive git@github.com:open-power/op-build.git
-cd op-build
-. op-build-env
-op-build palmetto_defconfig && op-build
-
-Building on *64-bit* Ubuntu/Debian systems
-==========================================
-
-1. Install Ubuntu 14.04 or Debian 7.5 64-bit.
-2. Install the packages necessary for the build:
-> sudo apt-get install cscope ctags libz-dev libexpat-dev \
- python language-pack-en texinfo \
- build-essential g++ git bison flex unzip \
- libxml-simple-perl libxml-sax-perl libxml2-dev libxml2-utils xsltproc
-3. Continue with the clone, environment setup, and build as noted above.
-
-Building on *64-bit* Fedora systems
-==========================================
-
-1. Install Fedora 20 64-bit.
-2. Install the packages necessary for the build:
-> sudo dnf install vim gcc-c++ flex bison git ctags cscope expat-devel patch \
- zlib-devel zlib-static make unzip tar bzip2 python wget cpio \
- bc xz findutils perl-XML-Simple perl-Thread-Queue perl-Env \
- perl-XML-LibXML perl-Digest-SHA1 perl-bignum libxml2-devel \
- libxslt hostname
-3. Continue with the clone, environment setup, and build as noted above.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..792109d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# OpenPower Firmware Build Environment
+
+The OpenPower firmware build process uses Buildroot to create a toolchain and
+build the various components of the PNOR firmware, including Hostboot, Skiboot,
+and Petitboot.
+
+## Building an image
+
+```
+git clone --recursive git@github.com:open-power/op-build.git
+cd op-build
+. op-build-env
+op-build palmetto_defconfig && op-build
+```
+
+### Dependancies for *64-bit* Ubuntu/Debian systems
+
+1. Install Ubuntu (>= 14.04) or Debian (>= 7.5) 64-bit.
+2. Install the packages necessary for the build:
+```
+sudo apt-get install cscope ctags libz-dev libexpat-dev \
+ python language-pack-en texinfo \
+ build-essential g++ git bison flex unzip \
+ libxml-simple-perl libxml-sax-perl libxml2-dev libxml2-utils xsltproc
+```
+
+### Dependancies for *64-bit* Fedora systems
+
+1. Install Fedora 23 64-bit.
+2. Install the packages necessary for the build:
+```
+sudo dnf install vim gcc-c++ flex bison git ctags cscope expat-devel patch \
+ zlib-devel zlib-static make unzip tar bzip2 python wget cpio \
+ bc xz findutils perl-XML-Simple perl-Thread-Queue perl-Env \
+ perl-XML-LibXML perl-Digest-SHA1 perl-bignum libxml2-devel \
+ libxslt hostname
+```