Modernize README using Markdown

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>

diff --git a/README b/README
deleted file mode 100644 (file)
index 52b8fa2..0000000
--- a/README
+++ /dev/null
@@ -1,9 +0,0 @@
-ctf-testsuite
-=============
-
-The Common Trace Format (CTF) testsuite is intended to validate the
-conformance of CTF readers.
-
-To run the testsuite simply export CTF_READER_BIN="$YOUR_CTF_READER" and
-use the run.sh script found in the tests/x.y/ folder, x.y being the CTF
-specification version you want to check.

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..52fabe8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+ctf-testsuite
+=============
+
+The Common Trace Format (CTF) test suite is intended to validate the
+conformance of CTF readers.
+
+To run the test suite:
+
+  1. Set the `CTF_READER_BIN` environment variable to your CTF reader
+    executable, e.g.:
+
+        export CTF_READER_BIN=my-ctf-reader
+
+  2. Execute the `run.sh` script found in the `tests/x.y` directory,
+     where `x.y` is the CTF specification's version you want to check,
+     e.g.:
+
+        ( cd tests/1.8 && ./run.sh )
+
+You may also set the `CTF_READER_OPTS` environment variable to options
+to pass to the CTF reader defined by `CTF_READER_BIN`.