[commit: testsuite] master: Update readme to markdown and expand. (a382825)

[David Terei]

Repository : ssh://darcs.haskell.org//srv/darcs/testsuite

On branch  : master

https://github.com/ghc/testsuite/commit/a38282555686d460184f8cf58059bf3dff99f891

>---------------------------------------------------------------

commit a38282555686d460184f8cf58059bf3dff99f891
Author: David Terei <davidterei at gmail.com>
Date:   Thu Jun 6 12:06:27 2013 -0700

    Update readme to markdown and expand.

>---------------------------------------------------------------

 README    |    7 -------
 README.md |   39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 7 deletions(-)

diff --git a/README b/README
deleted file mode 100644
index 9198eb3..0000000
--- a/README
+++ /dev/null
@@ -1,7 +0,0 @@
-GHC Testsuite Readme
---------------------
-
-For testsuite documentation, please see:
-
-    http://hackage.haskell.org/trac/ghc/wiki/Building/RunningTests
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9b52e30
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+GHC Testsuite Readme
+====================
+
+For the full testsuite documentation, please see [here][1].
+
+## Quick Guide
+
+Commands to run testsuite:
+
+ * Full testsuite: `make`
+ * Using more threads: `make THREADS=12`
+ * Reduced (fast) testsuite: `make fast`
+ * Run a specific test: `make TEST=tc054`
+ * Test a specific 'way': `make WAY=optllvm`
+ * Test a specifc stage of GHC: `make stage=1`
+ * Pass in extra GHC options: `make EXTRA_HC_OPTS=-fvectorize`
+
+You can also change directory to a specific test folder to run that
+individual test or group of tests. For example:
+
+``` .sh
+$ cd tests/array
+$ make
+```
+
+## Testsuite Ways
+
+The testsuite can be run in a variety of 'ways'. This concept refers
+to different ways that GHC can compile the code. For example, using
+the native code generator (`-fasm`) is one way, while using the LLVM
+code generator (`-fllvm`) is another way.
+
+The various ways that GHC supports are defined in `config/ghc`
+
+## Adding Tests
+
+Please see the more extensive documentation [here][1].
+
+  [1]: http://hackage.haskell.org/trac/ghc/wiki/Building/RunningTests