Merge pull request #88 from tudortimi/fix-readme
Fix README
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cccc1b5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# SVUnit
+
+SVUnit is an open-source test framework for ASIC and FPGA developers writing Verilog/SystemVerilog
+code. SVUnit is automated, fast, lightweight and easy to use making it the only SystemVerilog test
+framework in existence suited to both design and verification engineers that aspire to high quality
+code and low bug rates.
+
+NOTE: for instructions on how to get going with SVUnit, go to
+ www.agilesoc.com/svunit.
+
+NOTE: Refer also to the FAQ at: www.agilesoc.com/svunit/svunit-FAQ
+
+
+## Release Notes
+
+Go [here](CHANGELOG.md) for release notes.
+
+
+## Step-by-step instructions to get a first unit test going
+
+### 1. Set up the `SVUNIT_INSTALL` and `PATH` environment variables
+
+```shell
+export SVUNIT_INSTALL=`pwd`
+export PATH=$PATH:$SVUNIT_INSTALL"/bin"
+```
+
+You can source `Setup.bsh` if you use the bash shell.
+
+```shell
+source Setup.bsh
+```
+
+You can source `Setup.csh` if you use the csh shell.
+
+```shell
+source Setup.csh
+```
+
+### 2. Go somewhere outside `SVUNIT_INSTALL` (i.e. where you are right now)
+
+Start a class-under-test:
+
+
+ // file: bogus.sv
+ class bogus;
+ endclass
+
+### 3. Generate the unit test
+
+```shell
+create_unit_test.pl bogus.sv
+```
+
+### 4. Add tests using the helper macros
+
+ // file: bogus_unit_test.sv
+ `SVUNIT_TESTS_BEGIN
+
+ //===================================
+ // Unit test: test_mytest
+ //===================================
+ `SVTEST(test_mytest)
+ `SVTEST_END
+
+ `SVUNIT_TESTS_END
+
+### 5. Run the unit tests
+
+```shell
+runSVUnit -s <simulator> # simulator is ius, questa, modelsim, riviera or vcs
+```
+
+### 6. Repeat steps 4 and 5 until done
+
+### 7. Pat self on back
diff --git a/README.txt b/README.txt
deleted file mode 100644
index e8311a1..0000000
--- a/README.txt
+++ /dev/null
@@ -1,76 +0,0 @@
-############################################################################
-#
-# Copyright 2011 The SVUnit Authors.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-############################################################################
-
-NOTE: for instructions on how to get going with SVUnit, go to
- www.agilesoc.com/svunit.
-
-NOTE: Refer also to the FAQ at: www.agilesoc.com/svunit/svunit-FAQ
-
-
-
------------------------------------------------------------
-Release Notes...
------------------------------------------------------------
-See RELEASE.txt for release notes
-
-
-
------------------------------------------------------------
-Step-by-step instructions to get a first unit test going...
------------------------------------------------------------
-
-1) setup the SVUNIT_INSTALL and PATH environment variables
->export SVUNIT_INSTALL=`pwd`
->export PATH=$PATH:$SVUNIT_INSTALL"/bin"
-
-1a) or you can source the Setup.bsh (if you use the bash shell)
->source Setup.bsh
-
-1b) or you can source the Setup.csh (if you use the csh shell)
->source Setup.csh
-
-2) go somewhere outside SVUNIT_INSTALL (i.e. where you are right now)
-and start a class-under-test
----
- bogus.sv:
- class bogus;
- endclass
----
-
-3) generate the unit test
->create_unit_test.pl bogus.sv
-
-4) add tests using the helper macros
----
- bogus_unit_test.sv:
- `SVUNIT_TESTS_BEGIN
- //===================================
- // Unit test: test_mytest
- //===================================
- `SVTEST(test_mytest)
- `SVTEST_END
-
- `SVUNIT_TESTS_END
----
-
-5) run the unittests
->runSVUnit -s <simulator> # simulator is ius, questa, modelsim, riviera or vcs
-
-6) repeat steps 4 and 5 until done
-
-7) pat self on back