reformat with markdown

unlvtests/README.md

@@ -1,55 +1,70 @@
-How to run UNLV tests.
+## How to run UNLV tests.
 
 The scripts in this directory make it possible to duplicate the tests
 published in the Fourth Annual Test of OCR Accuracy.
 See http://www.isri.unlv.edu/downloads/AT-1995.pdf
 but first you have to get the tools and data used by  UNLV:
 
-Step 1: to download the images go to
+### Step 1: to download the images go to
 https://sourceforge.net/projects/isri-ocr-evaluation-tools-alt/files/ 
 and get doe3.3B.tar.gz, bus.3B.tar.gz, mag.3B.tar.gz and news.3B.tar.gz
 spn.3B.tar.gz is incorrect in this repo, so get it from code.google
 
+```
 mkdir -p ~/isri-downloads
 cd ~/isri-downloads
 curl  -L https://sourceforge.net/projects/isri-ocr-evaluation-tools-alt/files/bus.3B.tar.gz > bus.3B.tar.gz
 curl  -L https://sourceforge.net/projects/isri-ocr-evaluation-tools-alt/files/doe3.3B.tar.gz > doe3.3B.tar.gz
 curl  -L https://sourceforge.net/projects/isri-ocr-evaluation-tools-alt/files/mag.3B.tar.gz > mag.3B.tar.gz
 curl  -L https://sourceforge.net/projects/isri-ocr-evaluation-tools-alt/files/news.3B.tar.gz > news.3B.tar.gz
 curl  -L https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/isri-ocr-evaluation-tools/spn.3B.tar.gz > spn.3B.tar.gz
+```
 
-Step 2: extract the files. It doesn't really matter where
+### Step 2: extract the files. 
+It doesn't really matter where
 in your filesystem you put them, but they must go under a common
 root so you have directories doe3.3B, bus.3B, mag.3B and news.3B. in, for example,
 ~/ISRI-OCRtk.
 
+```
 mkdir -p ~/ISRI-OCRtk
 cd ~/ISRI-OCRtk
 tar xzvf ~/isri-downloads/bus.3B.tar.gz
 tar xzvf ~/isri-downloads/doe3.3B.tar.gz
 tar xzvf ~/isri-downloads/mag.3B.tar.gz
 tar xzvf ~/isri-downloads/news.3B.tar.gz
 tar xzvf ~/isri-downloads/spn.3B.tar.gz
+```
 
-**** Edit ~/ISRI-OCRtk/spn.3B/pages
+Edit *~/ISRI-OCRtk/spn.3B/pages*
 delete the line containing the following imagename as it crashes tesseract.
+
 7733_005.3B.tif
 
-Step 4: Download the modified ISRI toolkit and make and install the tools :
+### Step 3: Download the modified ISRI toolkit, make and install the tools :
+These will be installed in /usr/local/bin.
 
+```
 git clone https://github.com/Shreeshrii/ocr-evaluation-tools.git
 cd ~/ocr-evaluation-tools
 sudo make install
+```
 
-Step 6: cd back to your main tesseract-ocr dir and Build tesseract.
+### Step 4: cd back to your main tesseract-ocr dir and Build tesseract.
 
-Step 7: run unlvtests/runalltests.sh with the root ISRI data dir and testname, tessdata-dir and language:
+### Step 5: run unlvtests/runalltests.sh with the root ISRI data dir, testname, tessdata-dir and language:
 
+```
 unlvtests/runalltests.sh ~/ISRI-OCRtk 4_fast_eng ../tessdata_fast eng
-and go to the gym, have lunch etc.
+```
+and go to the gym, have lunch etc. It takes a while to run.
 
-Step 8: There should be a file
-unlvtests/reports/4-beta_fast.summary that contains the final summarized accuracy
+### Step 6: There should be a RELEASE.summary file
+*unlvtests/reports/4-beta_fast.summary* that contains the final summarized accuracy
 report and comparison with the 1995 results.
 
+### Step 7: run the test for Spanish.
+
+```
 unlvtests/runalltests.sh ~/ISRI-OCRtk 4_fast_spa ../tessdata_fast spa
+```