Markdown cleanup pass on ray4/README.md

ray4/README.md

@@ -1,53 +1,44 @@
-
-This is ray4, version 1.30.  Ray4 is a 4D raytracer that I wrote for my
-master's thesis in May 1991 ("Four-Space Visualization of 4D Objects").  The
-thesis is available via anonymous FTP in both PostScript and TROFF formats,
-at ftp.kpc.com.
-
-    This release should include the following files:
-
-    README                // This File
-    copyright             // Ray4 Release Copyright
-    ray4.doc              // Ray4 Documentation
-
-    makefile              // Program Make File (Unix)
-    makefile-Amiga        // Program Make File (Amiga)
-    ray4.h                // Main Header File
-    r4_globals.h          // Ray4 Global Variables
-    r4_image.h            // Ray4 Image Cube File Format Structures
-    vector.h              // Vector Operation Macros
-    v4cross.c             // Vector Cross-Product Routine
-    v4normalize.c         // Vector Normalization Routine
-    r4_main.c             // Main Ray4 Functions
-    r4_io.c               // Ray4 Input/Output Functions (for portability)
-    r4_parse.c            // Ray4 Input File Parsing Routines
-    r4_trace.c            // Ray4 Raytracing Routines
-    r4_hit.c              // Ray4 Ray-Object Intersection Routines
-    r4tosgi.c             // Ray4 Output File to GL-Device Display Program
-    r4toiff.c             // Ray4 Output File to Amiga display & IFF File
-
-    scube.r4              // Example Input Files
-    sphere.r4
-    tcube.r4
-    dots.r4
-    dots3.r4
-    dots4.r4
-    format.r4
-    blank.r4
-    wdots.r4
-
-You will probably need to tweak the makefile to get it to run on your
-platform.  I've tried to make this as straightforward as possible, but let
-me know if you have problems.
+ray4
+====================================================================================================
+
+This is ray4, a 4D raytracer I wrote for my master’s thesis in May 1991
+([“Four-Space Visualization of 4D Objects”](http://hollasch.github.io/ray4)).
+
+This project includes the following files:
+
+| File           | Description
+|----------------|-----------------------------------------------
+| README.md      | This File
+| copyright      | Ray4 Release Copyright
+| ray4.doc       | Ray4 Documentation
+| makefile       | Program Make File (Unix)
+| makefile-Amiga | Program Make File (Amiga)
+| ray4.h         | Main Header File
+| r4_globals.h   | Ray4 Global Variables
+| r4_image.h     | Ray4 Image Cube File Format Structures
+| vector.h       | Vector Operation Macros
+| v4cross.c      | Vector Cross-Product Routine
+| v4normalize.c  | Vector Normalization Routine
+| r4_main.c      | Main Ray4 Functions
+| r4_io.c        | Ray4 Input/Output Functions (for portability)
+| r4_parse.c     | Ray4 Input File Parsing Routines
+| r4_trace.c     | Ray4 Raytracing Routines
+| r4_hit.c       | Ray4 Ray-Object Intersection Routines
+| r4tosgi.c      | Ray4 Output File to GL-Device Display Program
+| r4toiff.c      | Ray4 Output File to Amiga display & IFF File
+| scube.r4<br>sphere.r4<br>tcube.r4<br>dots.r4<br>dots3.r4<br>dots4.r4<br>format.r4<br>blank.r4<br>wdots.r4 | Example Input Files
+
+You will probably need to tweak the makefile to get it to run on your platform. I’ve tried to make
+it as straightforward as possible, but let me know if you have problems.
 
 
 Beta Testers
 ------------
-    Greg Aharonian
-    Brian Carney
-    Mark Craig
-    Mark Ferneau
-    Marty Ryan
+- Greg Aharonian
+- Brian Carney
+- Mark Craig
+- Mark Ferneau
+- Marty Ryan
 
 
 Example Run
@@ -57,5 +48,5 @@ Example Run
     r4toiff dots.icube -t
 
 
-/////////////////////////////////////////////////////////////////////////////
-Steve Hollasch ([email protected])                            08-February-1993
+----
+Steve Hollasch / [email protected]