From 3d4d6669cc995944a1a257902e57591346ad6150 Mon Sep 17 00:00:00 2001
From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com>
Date: Fri, 14 Apr 2023 06:22:23 -0700
Subject: [PATCH] Update 1990 winning entries' README.md files

Format and typo fixes.
---
 1990/cmills/README.md  |  7 ++++---
 1990/dds/README.md     | 12 +++++++-----
 1990/jaw/README.md     |  6 +++---
 1990/pjr/README.md     |  2 ++
 1990/theorem/README.md | 33 ++++++++++++++++++---------------
 1990/westley/README.md | 15 ++++++++-------
 6 files changed, 42 insertions(+), 33 deletions(-)

diff --git a/1990/cmills/README.md b/1990/cmills/README.md
index 37b9fdb49..135ff7cca 100644
--- a/1990/cmills/README.md
+++ b/1990/cmills/README.md
@@ -12,7 +12,7 @@ USA
 make all
 ```
 
-## To run
+## To run:
 
 ```sh
 ./cmills [starting_cash]
@@ -23,8 +23,9 @@ work in modern systems (it resulted in a bus error otherwise). Thank you Yusuke
 for your assistance!
 
 [Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) made this safer by
-using `fgets()` instead of `gets()`. This avoids a potentially alarming warning
-at compiling and/or linking and/or runtime. Thank you Cody for your assistance!
+using `fgets()` instead of `gets()`. This avoids an annoying and potentially
+alarming warning at compiling and/or linking and/or runtime that in some cases
+is interspersed with the program's output. Thank you Cody for your assistance!
 
 For the original code see the [1992 archive](/archive/archive-1990.tar.bz2).
 
diff --git a/1990/dds/README.md b/1990/dds/README.md
index 9392b5778..a18fc84c6 100644
--- a/1990/dds/README.md
+++ b/1990/dds/README.md
@@ -5,11 +5,13 @@ Imperial College, University of London
 Myrsinis 1  
 GR-145 62 Kifissia  
 Greece  
-<https://www.spinellis.gr/>
+<https://www.spinellis.gr/>  
 
 ## To build:
 
-	make all
+```sh
+make all
+```
 
 
 [Yusuke Endoh](/winners.html#Yusuke_Endoh) fixed this for modern systems. Thank
@@ -17,10 +19,10 @@ you Yusuke!
 
 [Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) removed the erroneous
 prototype to `fopen()` and made this use `fgets()` instead of `gets()` to make
-it safer and to prevent a potentially alarming warning at compiling and/or
-linking and/or runtime. Thank you Cody for your assistance!
+it safer and to prevent an annoying and potentially alarming warning at
+compiling and/or linking and/or runtime. Thank you Cody for your assistance!
 
-## To run
+## To run:
 
 ```sh
 ./dds
diff --git a/1990/jaw/README.md b/1990/jaw/README.md
index 59e831414..aaed01a8f 100644
--- a/1990/jaw/README.md
+++ b/1990/jaw/README.md
@@ -27,7 +27,7 @@ make all
 
 [Cody Boone Ferguson](/winners.html#Cody_Boone_Ferguson) fixed the script to
 work properly in modern environments (to do with PATH not having '.' in it). He
-notes that with an invocation in the try section below you will with macOS get
+notes that with an invocation in the try section below will with macOS show
 what appears to be an error message but is actually okay. He gives more
 information in the [bugs.md](/bugs.md) file. Thank you Cody for the help and
 notes!
@@ -136,7 +136,7 @@ environment.
 
 ----------------------------------------------
 
-### Portability:
+### Portability
 
 We have ported this program to a wide variety of systems. Among
 these are:
@@ -152,7 +152,7 @@ these are:
 - Dynix / Sequent Balance ('cc' for Natl. Semi. base + 'gcc 1.36')
 - Unicos / Cray 2
 
-### Obfuscation:
+### Obfuscation
 
 We (the authors) feel this program is obfuscated for the
 following reasons:
diff --git a/1990/pjr/README.md b/1990/pjr/README.md
index 462f00d91..5d296e1f7 100644
--- a/1990/pjr/README.md
+++ b/1990/pjr/README.md
@@ -51,6 +51,8 @@ to functions!
 
 ## Author's remarks:
 
+Rot13:
+
     Vg vf fvzcyr gb znxr gur cebtenz cevag bgure fgevatf.  Rnpu
     nycunorgvpny punenpgre sebz n gb m vf cevagrq bhg nf vgf
     bccbfvgr:
diff --git a/1990/theorem/README.md b/1990/theorem/README.md
index 6dc5e4a37..0beac04a8 100644
--- a/1990/theorem/README.md
+++ b/1990/theorem/README.md
@@ -21,9 +21,9 @@ that dump core when NULL is dereferenced but this problem showed itself in
 modern systems even with the 4 '0 0 0 0'. He also fixed a segfault if not enough
 args are specified and fixed the code so that the generated `fibonacci.c`
 actually works; before it just printed `0` over and over again (since it did not
-work anyway a segfault prevention was added here). He also some array addressing
-(some of which might not be strictly necessary but as he was testing the
-`fibonacci.c` bug he ended up changing it anyway). Finally he changed this
+work anyway a segfault prevention was added here). He also fixed some array
+addressing (some of which might not be strictly necessary but as he was testing
+the `fibonacci.c` bug he ended up changing it anyway). Finally he changed this
 program to use `fgets()` not `gets()` to make it safer and to prevent a warning
 about `gets()` at linking or runtime. Thank you Cody for your assistance!
 
@@ -40,12 +40,13 @@ initially. Thank you Yusuke!
 
 where:
 
-	expression - function f(x,y)  (see below)
-	x1 - start of interval
-	x2 - end of interval
-	h - step size
-	y1 - initial value  (y(x1) == y1)
-
+```
+expression - function f(x,y)  (see below)
+x1 - start of interval
+x2 - end of interval
+h - step size
+y1 - initial value  (y(x1) == y1)
+```
 
 ## Try:
 
@@ -65,15 +66,17 @@ The program's source implements four functions, all from the
 same source file!
 
 When you compile theorem.c as is and run with 5 args, it numerically
-solves the equation y'=f(x,y), with a step size of h, over the interval 
-x=[x1,x2], with the initial condition of y(x1)=y1.
+solves the equation `y'=f(x,y)`, with a step size of `h`, over the interval 
+`x=[x1,x2]`, with the initial condition of `y(x1)=y1`.
 
-The 'expression' f(x,y), is any function of 'x' and 'y' with the
+The 'expression' `f(x,y)` is any function of `x` and `y` with the
 operators:
 
-	    +	-	*	/	^
+```
++	-	*	/	^
+```
 
-The symbol '^' is the power operator.  Note that it only supports
+The symbol `^` is the power operator.  Note that it only supports
 integer powers.  Also note that all expressions are evaluated strictly 
 left to right.  (i.e., parenthesis aren't supported).
 
@@ -128,7 +131,7 @@ received a standing ovation; a first for a contest entry.
 ## Author's remarks:
 
 Differential equations are solved via the Runge-Kutta method, which guarantees
-local error proportional to h^5, and total error across a finite interval is at
+local error proportional to `h^5`, and total error across a finite interval is at
 most a constant times `h^4`.
 
 Sorting is accomplished with a standard shell sort.
diff --git a/1990/westley/README.md b/1990/westley/README.md
index aa12f16a2..8c692d9db 100644
--- a/1990/westley/README.md
+++ b/1990/westley/README.md
@@ -55,18 +55,19 @@ Use `westley.alt` as you would `westley`.
 
 ## Judges' remarks:
 
-
 If you would rather "Daisy" someone other than Westley, rename 
 the program as needed.  :-)
 
 Read each block of code as if it were a piece of correspondence.
 For example, the first block of code would read:
 
-	charlie,
-		doubletime me, OXFACE!
-		not interested, get out
-		mainly die, charly, *die*
-			signed charlotte
+```
+charlie,
+	doubletime me, OXFACE!
+	not interested, get out
+	mainly die, charly, *die*
+		signed charlotte
+```
 
 The original source had control-L's after each code block.  To 
 make it easier on news readers, we converted each control-L to 
@@ -86,7 +87,7 @@ Lint complains about everything - null effect, xxx may be used before
 set, statement not reached, return(e) and return.  Lint dumps core
 on some systems.  My personal favorite lint complaint is
 
-    	"warning: eroticism unused in function main".
+**_"warning: eroticism unused in function main"._**
     
 Also obviously, `(char)lotte` and `(char*)lie` are incompatible types...