improve how markdown code language is commented

We added a space between the markdown triple code mark
and language that was enclosed in HTML comments.

So a line of the form:

````
```<!---c--->
````

became:

````
``` <!---c--->
````

This was done to **help** some code see that the HTML comment
string was not a markdown code specifier.   Not all code
understands this after this changed.  For example, `pandoc(1)`
still forms HTML classes of the form "&lt;!---c--&gt;"
when it encounters the above mentioned change.

We also fixed a problem with `2019/dogon/README.md` regarding
a markdown code block.

We also fixed a problem with `2020/yang/README.md` regarding
a markdown code block.

2005/aidan/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,7 +10,7 @@ code](#alternate-code).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./aidan < puzzle
 
     ./aidan seed
@@ -21,7 +21,7 @@ where `seed` is a number.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -34,7 +34,7 @@ which is slower, inelegant and not as obscure, as the author put it.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -46,7 +46,7 @@ Use `aidan.alt` as you would `aidan` above.
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.alt.sh
 ```
 
@@ -139,7 +139,7 @@ Telegraph](https://www.telegraph.co.uk/), a UK newspaper.
 
 Now, with modern computers this **can** be solved using brute force, e.g.:
 
-```<!---c-->
+``` <!---c-->
     #include <stdio.h> /* sudoku-bfi.c */
     #define S(t) for(n=0;n<9;v[n++]=0);for(n=0;n<81;n++)if(i[n]){z=1<<i[n];if(v[t]\\
     &z)for(;;){if(p<0)goto d;if(i[p]++<9)goto f;i[p]=0;p=s[p];}v[t]|=z;}
@@ -186,20 +186,20 @@ reasons. That's the worst performance I've had from brute-force so far!)
 
 #### Building
 
-```<!---sh-->
+``` <!---sh-->
     cc -o sudoku-sf sudoku-sf.c
 ```
 
 or, if using gcc, try:
 
-```<!---sh-->
+``` <!---sh-->
     gcc -O2 -Wall -Wextra -ansi -pedantic-errors -o sudoku-sf sudoku-sf.c
 ```
 
 
 #### Testing (optional)
 
-```<!---sh-->
+``` <!---sh-->
     perl ./test-su.perl
 ```
 
@@ -211,7 +211,7 @@ really.
 
 #### Solving
 
-```<!---sh-->
+``` <!---sh-->
     ./aidan < somefile.txt
 ```
 
@@ -232,7 +232,7 @@ though slightly slower. See if you can figure out what it does.)
 
 #### Generating
 
-```<!---sh-->
+``` <!---sh-->
     ./sudoku <seed>
 ```
 
@@ -292,7 +292,7 @@ least 32. (No, that isn't a typo - I did say 15, not 16).
 
 Also requires that `cpp` can properly handle something like:
 
-```<!---c-->
+``` <!---c-->
     #define foo(x,y) x y
     foo(bar,)
 ```

2005/anon/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -8,7 +8,7 @@ NOTE: there is an alternate version for vi(m) like movements. See [alternate
 version](#alternate-code) below. If your terminal has problems with the
 `stty(1)` commands try:
 
-```<!---sh-->
+``` <!---sh-->
     make anon-no_stty
 ```
 
@@ -28,14 +28,14 @@ For more detailed information see [2005 anon bugs](../../bugs.html#2005_anon).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./anon x y [z]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./anon 4 4
 
     ./anon 3 3 3
@@ -48,13 +48,13 @@ hook you) and spending too much time playing. :-)
 
 If you want to see this in action you can easily do this:
 
-```<!---sh-->
+``` <!---sh-->
     yes 'please crash on me :-)' | ./anon 4 4
 ```
 
 What happens if you specify a larger board? For instance:
 
-```<!---sh-->
+``` <!---sh-->
     yes 'please crash on me :-)' | ./anon 10 10 10
 ```
 
@@ -70,13 +70,13 @@ The alternate version uses `vi(m)` like movement keys.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
 To compile the version without `stty(1)`:
 
-```<!---sh-->
+``` <!---sh-->
     make alt-no_stty
 ```
 
@@ -121,13 +121,13 @@ sorted in the order they appear on the screen.
 The program takes 2 or 3 arguments, specifying the dimensions of the board.
 For example, to play the original version of the Fifteen Puzzle:
 
-```<!---sh-->
+``` <!---sh-->
     ./anon 4 4
 ```
 
 To play with a 3D board, do something like this:
 
-```<!---sh-->
+``` <!---sh-->
     ./anon 3 3 3
 ```
 
@@ -377,7 +377,7 @@ stored in a well-known location in the `MASS`.
 
 `if(p,q,r,s)` is, in fact, an `if` statement. :-) It is equivalent to:
 
-```<!---c-->
+``` <!---c-->
     if (p) { q; r } else {s}
 ```
 
@@ -404,7 +404,7 @@ closes the current state and opens a new one behind the programmer's back.
 variable); `x` and `y-1` define the starting and ending values of `i`, and `z`
 is the loop body. `Z` is the post-loop code in the current state. For example:
 
-```<!---c-->
+``` <!---c-->
     for(s,i, 0, 10,
     some_code       ,
     other_code)
@@ -412,7 +412,7 @@ is the loop body. `Z` is the post-loop code in the current state. For example:
 
 is equivalent to:
 
-```<!---c-->
+``` <!---c-->
     for (i=0; i&lt;10; i++) {
 	    some_code;
     }

2005/boutines/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -15,20 +15,20 @@ require it?](../../faq.html#imagemagick).
 Look here to find some [SVG Viewer
 Implementations](https://www.w3.org/Graphics/SVG/WG/wiki/Implementations).
 
-```<!---sh-->
+``` <!---sh-->
     ./boutines < input > output.svg
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
 If `ruby` is installed [try.sh](try.sh) will generate an SVG file by:
 
-```<!---sh-->
+``` <!---sh-->
     ruby -e '20.times{puts "#{rand} #{rand}"}' | ./boutines > test.svg
 ```
 
@@ -75,7 +75,7 @@ an [SVG](https://www.w3.org/TR/SVG11/expanded-toc.html) stream.
 
 This will possibly save a compressed SVG file and may be useful:
 
-```<!---sh-->
+``` <!---sh-->
     ./boutines | gzip > result.svg.gz
 ```
 

2005/chia/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./chia
 ```
 

2005/giljade/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -21,21 +21,21 @@ For more detailed information see [2005 giljade bugs](../../bugs.html#2005_gilja
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./giljade
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
 
 ### Self-test feature to try:
 
-```<!---sh-->
+``` <!---sh-->
     ./giljade > out
     ./giljade out
 ```
@@ -52,7 +52,7 @@ Control-F.
 
 If you really understand expressions, then understand this:
 
-```<!---c-->
+``` <!---c-->
     s=s^(b=s&s-1^s)
 ```
 

2005/jetro/README.md

@@ -6,14 +6,14 @@ haven't already.
 
 If you have SDL installed:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./jetro
 ```
 

2005/klausler/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./klausler arg1 arg2 | head
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 

2005/mikeash/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -18,7 +18,7 @@ For more detailed information see [2005 mikeash bugs](../../bugs.html#2005_mikea
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./mikeash
 ```
 
@@ -28,7 +28,7 @@ under 64-bit (x86_64, arm64) machines too.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -67,7 +67,7 @@ functions.
 
 Try:
 
-```<!---sh-->
+``` <!---sh-->
     echo '(format t "~s" (+ 2 2 ))' | ./mikeash
 ```
 
@@ -76,7 +76,7 @@ the lack of a newline are due to the somewhat broken implementation of
 the format function. More sophisticated arithmetic expressions may be
 used:
 
-```<!---sh-->
+``` <!---sh-->
     echo '(format t "~s" (* (+ 2 2 ) (- 5 (/ 9 3 ))))' | ./mikeash
 ```
 
@@ -130,7 +130,7 @@ nowhere near
 Basically, the [LISP][] interpreter is good for some basic math operations, and
 for running itself. To do the latter, try this:
 
-```<!---sh-->
+``` <!---sh-->
     ./mikeash < mikeash.c > mikeash2.c
     diff mikeash.c mikeash2.c
 ```

2005/mynx/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -21,7 +21,7 @@ For more detailed information see [2005 mynx bugs](../../bugs.html#2005_mynx).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./mynx http://<domain>
 ```
 
@@ -31,7 +31,7 @@ the issue of https.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./mynx http://www.textfiles.com
 
     ./mynx manual.html
@@ -58,7 +58,7 @@ must just appreciate the entry for what it once was.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -68,7 +68,7 @@ must just appreciate the entry for what it once was.
 Use `mynx.alt` as you would `mynx`. You'd have to specify a port at the end of
 the URL like:
 
-```<!---sh-->
+``` <!---sh-->
     ./mynx.alt https://www.ioccc.org:443
 ```
 
@@ -92,13 +92,13 @@ it inspired me to try my hand at writing the client side complement.
 
 A typical build command would be:
 
-```<!---sh-->
+``` <!---sh-->
     cc -o mynx mynx.c
 ```
 
 While some others like to be a little different:
 
-```<!---sh-->
+``` <!---sh-->
     cc -o mynx mynx.c -lnsl -lsocket
 ```
 
@@ -107,13 +107,13 @@ example, which is kinda of useful when you consider how many OSes put
 all the network functions in a variety of places. So a simpler build
 command sequence would be:
 
-```<!---sh-->
+``` <!---sh-->
     cd source ; ./configure ; make
 ```
 
 After which, the rest of the documentation can be read by saying:
 
-```<!---sh-->
+``` <!---sh-->
     ./mynx ../manual.html
 ```
 

2005/persano/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,14 +10,14 @@ setting binary mode on `stdout`. See [alternate code](#alternate-code) below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./persano p q [num frames]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -49,7 +49,7 @@ Use `persano.alt` as you would `persano` above.
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./persano.alt 3 16 > knot3-16.gif
 ```
 
@@ -80,7 +80,7 @@ knots](https://en.wikipedia.org/wiki/Torus_knot) to standard output.
 
 ### SYNOPSIS
 
-```<!---sh-->
+``` <!---sh-->
     ./persano p q [num frames]
 ```
 
@@ -98,14 +98,14 @@ cutting it [^1], until it ends up looking just like a circle embedded in R3 [^2]
 
 Sample usage:
 
-```<!---sh-->
+``` <!---sh-->
     ./persano 3 2 1 > foo.gif
 ```
 
 writes a non-animated GIF (a single frame) stream of a rendered trefoil
 knot to the file `foo.gif`.
 
-```<!---sh-->
+``` <!---sh-->
     ./persano 5 2
 ```
 

2005/sykes/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -18,14 +18,14 @@ For more detailed information see [2005 sykes bugs](../../bugs.html#2005_sykes).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes binary_file
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -44,7 +44,7 @@ We downloaded the [ROM](https://en.wikipedia.org/wiki/ROM_image) contents to use
 the [emulator](https://en.wikipedia.org/wiki/Emulator) in
 [PET](https://en.wikipedia.org/wiki/Commodore_PET) mode as follows:
 
-```<!---sh-->
+``` <!---sh-->
     wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-c000.901465-01.bin
     wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/basic-2-d000.901465-02.bin
     wget http://www.zimmers.net/anonftp/pub/cbm/firmware/computers/pet/edit-2-n.901447-24.bin
@@ -53,7 +53,7 @@ the [emulator](https://en.wikipedia.org/wiki/Emulator) in
 
 We then created:
 
-```<!---sh-->
+``` <!---sh-->
     dd bs=2k count=1 if=/dev/zero of=nullfill.bin
 ```
 
@@ -79,7 +79,7 @@ Compile the program, then test the
 [6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
 [emulation](https://en.wikipedia.org/wiki/Emulator) like this:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes 6502test
 ```
 
@@ -105,7 +105,7 @@ Make sure you have a [terminal
 window](https://en.wikipedia.org/wiki/Terminal_emulator) of 40x25 chars or
 bigger, and then run the emulator like this:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes pet.rom
 ```
 
@@ -119,13 +119,13 @@ You should see the startup message. Try typing in some
 There is an optional numeric parameter, which controls the speed. For a
 slower cursor blink, try
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes pet.rom 6
 ```
 
 and for faster
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes pet.rom 2
 ```
 
@@ -191,7 +191,7 @@ Supplied as a demonstration is a
 compiled-for-[6502](https://en.wikipedia.org/wiki/MOS_Technology_6502#Technical_description)
 version a chess program (heh, I found a use for a previous losing entry :) ). Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes chess
 ```
 
@@ -306,7 +306,7 @@ from the Internet.  This is to avoid directly infringing any copyright.
 
 What does this do?
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes pet.rom -1
 ```
 

2005/timwi/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./timwi < bf_program
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 

2005/toledo/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo [a ...]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo a
     ./toledo a b
 ```
@@ -30,7 +30,7 @@ Two alternate versions of this entry, [toledo2.c](toledo2.c) and
 
 To compile the alternate versions:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -63,7 +63,7 @@ This is a [chess](https://en.wikipedia.org/wiki/Chess) program, it can work in
 two modes: two-players, and one player (always white) against the machine. To
 get the first mode, run the program without arguments:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo
 ```
 
@@ -71,14 +71,14 @@ The other mode is accessible running the program with one argument
 (5-[ply](https://en.wikipedia.org/wiki/Ply_(game_theory))
 analysis):
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo a
 ```
 
 Two arguments for 6-[ply](https://en.wikipedia.org/wiki/Ply_(game_theory))
 analysis:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo a b
 ```
 

2005/vik/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik [file.map]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik maze.map
 ```
 
@@ -60,7 +60,7 @@ Compile the source code and link in [X
 libraries](https://en.wikipedia.org/wiki/Xlib) if necessary. The program takes
 three options which have to be typed in a specific order as described below.
 
-```<!---sh-->
+``` <!---sh-->
     ./vik [-w <width>] [mapfile]
 ```
 
@@ -75,20 +75,20 @@ where:
 
 Start the engine using a built in labyrinth and texture bitmaps:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik
 ```
 
 Start the engine and loads the labyrinth defined in the file
 [maze.map](maze.map):
 
-```<!---sh-->
+``` <!---sh-->
     ./vik maze.map
 ```
 
 Start the engine using [maze.map](maze.map) in a window that is 400 pixels wide:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik -w 400 maze.map
 ```
 

2005/vince/README.md

@@ -3,14 +3,14 @@
 Before building, make sure that you have the OpenGL development libraries
 installed.
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./vince
 ```
 
@@ -31,7 +31,7 @@ also has the recursive `CPP` macro (which sneaked in accidentally) removed.
 
 To compile this alternate version:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```