Add BUILDING.md

RND-441

Author: amedee

BUILDING.md

@@ -0,0 +1,35 @@
+To build **pdfHTML**, [Maven][1] must be installed.
+
+Running install without a profile will generate the **pdfHTML** jar:
+```bash
+$ mvn clean install \
+    -Dmaven.test.skip=true \
+    -Dmaven.javadoc.failOnError=false \
+    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)
+```
+
+To run the tests, [Ghostscript][2] and [Imagemagick][3] must be installed.
+```bash
+$ mvn clean install \
+    -Dmaven.test.failure.ignore=false \
+    -DgsExec=$(which gs) \
+    -DcompareExec=$(which compare) \
+    -Dmaven.javadoc.failOnError=false \
+    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)
+```
+
+You can use the supplied `Vagrantfile` to get a [Vagrant][4] VM ([Ubuntu][5] 14.04 LTS - Trusty Tahr, with [VirtualBox][6]) with all the required software installed.
+```bash
+$ vagrant box add ubuntu/trusty64
+$ vagrant up
+$ vagrant ssh -- \
+    'cd /vagrant ; mvn clean install -Dmaven.test.skip=true -Dmaven.javadoc.failOnError=false' \
+    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)
+```
+
+[1]: http://maven.apache.org/
+[2]: http://www.ghostscript.com/
+[3]: http://www.imagemagick.org/
+[4]: https://www.vagrantup.com/
+[5]: http://www.ubuntu.com/
+[6]: https://www.virtualbox.org/