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.

2004/anonymous/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./anonymous 'foo' > bar.pgm
 ```
 
@@ -21,7 +21,7 @@ images.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -107,7 +107,7 @@ The following command thus writes a rendering of the [Ring
 inscription](https://www.glyphweb.com/arda/r/ringinscription.html) to
 the file `ring.pgm`:
 
-```<!---sh-->
+``` <!---sh-->
     ./anonymous "ash nazg durhbatuluhk, ash nazg gimbatul, \
 	ash nazg thrakatuluhk, agh burzhumh-ishi krimpatul." >ring.pgm
 ```

2004/arachnid/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -11,20 +11,20 @@ code](#alternate-code) below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./arachnid [mazefile]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./arachnid arachnid.txt
 ```
 
 and then try:
 
-```<!---sh-->
+``` <!---sh-->
     ./arachnid arachnid.c
 ```
 
@@ -41,7 +41,7 @@ instead.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -80,7 +80,7 @@ explorers out there.
 
 ### Usage
 
-```<!---sh-->
+``` <!---sh-->
     ./arachnid [mazefile]
 ```
 

2004/burley/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,7 +10,7 @@ will not work with it enabled.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./burley
 ```
 

2004/gavare/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,14 +10,14 @@ for more details.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./gavare > ioccc_ray.ppm
 ```
 
 Open `ioccc_ray.ppm` with a viewer capable of viewing PPM files. Alternatively,
 if you have ImageMagick installed, you can convert it to a jpeg:
 
-```<!---sh-->
+``` <!---sh-->
     convert ioccc_ray.ppm ioccc_ray.jpg
 ```
 
@@ -28,7 +28,7 @@ and then view `ioccc_ray.jpg` in a graphics viewer, editor or web browser.
 
 If you have `xv(1)` you can do:
 
-```<!---sh-->
+``` <!---sh-->
     ./gavare | xv -
 ```
 
@@ -53,19 +53,19 @@ on `stdout` which theoretically should work in Windows.
 
 To build the configurable and unobfuscated versions:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
 To change the default size from 1024x768 try:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber XX=640 YY=480 alt
 ```
 
 You might also wish to change the anti-alias setting:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber AA=2 alt
 ```
 
@@ -78,7 +78,7 @@ This is not possible with the author's version but it is with the alt versions
 As the Windows version will not compile on most viewers' systems we do not build
 it with `make alt`; instead try:
 
-```<!---sh-->
+``` <!---sh-->
     make alt2
 ```
 

2004/gavin/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -25,7 +25,7 @@ For more detailed information see [2004 gavin bugs](../../bugs.html#2004_gavin).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./gavin
 ```
 
@@ -36,14 +36,14 @@ To enjoy the results (on a Linux/x86 machine) with a floppy drive (remember
 those? We do!):
 
 
-```<!---sh-->
+``` <!---sh-->
     su
 ```
 
 Make a floppy with an ext2 filesystem (`mke2fs /dev/fd0` replacing `fd0` with
 whatever the floppy device is!),  mount it under `/mnt/floppy` and then:
 
-```<!---sh-->
+``` <!---sh-->
     cp kernel fs.tar lilo.conf boot.b /mnt/floppy
 ```
 
@@ -51,26 +51,26 @@ NOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.
 
 NOTE: If your floppy drive is not `/dev/fd0`, edit lilo.conf appropriately.
 
-```<!---sh-->
+``` <!---sh-->
     lilo -C /mnt/floppy/lilo.conf
 ```
 
 Boot from the floppy on an x86 machine with a PS/2 keyboard and mouse.
 Move the window away from the corner.
 
-```<!---sh-->
+``` <!---sh-->
     vi gavin.c
 ```
 
 Scroll up and down the file with up-arrow and down-arrow.
 
-```<!---sh-->
+``` <!---sh-->
     sh
 ```
 
 You can have several shell windows:
 
-```<!---sh-->
+``` <!---sh-->
     vi README.md
     ./prim
 ```
@@ -86,7 +86,7 @@ you can use it with `QEMU`.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 

2004/hibachi/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     cd build; ./hibachi-start.sh &
 ```
 
@@ -42,7 +42,7 @@ There is a `hibachi.tgz` file (NOTE: this file was removed by the judges after
 extraction) that unpacks several support files and a subdirectory tree
 containing the documentation and examples. It can be viewed by:
 
-```<!---sh-->
+``` <!---sh-->
     tar -zxf hibachi.tgz
     lynx hibachi/localhost/index.html
 ```
@@ -58,19 +58,19 @@ To build just the executable:
 
 For Cygwin, FreeBSD, Linux (newer), Mac OS X:
 
-```<!---sh-->
+``` <!---sh-->
     gcc -o hibachi hibachi.c
 ```
 
 For Linux (older):
 
-```<!---sh-->
+``` <!---sh-->
     gcc -DSHUT_WR=1 -o hibachi hibachi.c
 ```
 
 For SunOS:
 
-```<!---sh-->
+``` <!---sh-->
     gcc -o hibachi hibachi.c -lnsl -lsocket
 ```
 
@@ -88,20 +88,20 @@ examples. In which case the preferred build commands are:
 
 To start the server on the default port (8008):
 
-```<!---sh-->
+``` <!---sh-->
     cd build;
     ./hibachi-start.sh &
 ```
 
 To test the server:
 
-```<!---sh-->
+``` <!---sh-->
     lynx http://localhost:8008/
 ```
 
 To stop the server:
 
-```<!---sh-->
+``` <!---sh-->
     kill %1
 ```
 

2004/hoyle/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./hoyle point ...
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -47,13 +47,13 @@ passed in.
 
 For example, to graph `y = x^2`:
 
-```<!---sh-->
+``` <!---sh-->
     ./hoyle 0 0 1
 ```
 
 Note that:
 
-```<!---sh-->
+``` <!---sh-->
     ./hoyle 0 0 2
 ```
 

2004/jdalbec/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -21,14 +21,14 @@ For more detailed information see [2004 jdalbec bugs](../../bugs.html#2004_jdalb
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./jdalbec number ...
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -43,7 +43,7 @@ which line it is on.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -52,7 +52,7 @@ many number of lines to print on a line. Set at default to 11 protons, salt, if
 you wish to make it silver, 47 (a prime) protons, do:
 
 
-```<!---sh-->
+``` <!---sh-->
     make clobber Ag=47 alt
 ```
 
@@ -60,7 +60,7 @@ though it might be odd to have 47 numbers on a line as it would defeat the
 purpose. :-) Or if you prefer some prime, golden irony:
 
 
-```<!---sh-->
+``` <!---sh-->
     make clobber Ag=79 alt
 ```
 
@@ -72,7 +72,7 @@ Use `jdalbec.alt` as you would `jdalbec` above.
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.alt.sh
 ```
 

2004/kopczynski/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,14 +10,14 @@ will not work with it enabled.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./kopczynski < input_file
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -34,14 +34,14 @@ does.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./kopczynski.alt < kopczynski-10
     echo $?
 ```

2004/newbern/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./newbern [file.dat arg]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -34,14 +34,14 @@ This is a configurable `banner(1)`-like program.
 
 - To convert a character glyph into a data file:
 
-```<!---sh-->
+``` <!---sh-->
     ./newbern char < some_nicely_shaped_text >> data_file
 ```
 
 
 - To print a string using glyphs from a data file:
 
-```<!---sh-->
+``` <!---sh-->
     ./newbern data_file a_string
 ```
 

2004/omoikane/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./omoikane infile layout outfile
 ```
 
@@ -43,7 +43,7 @@ insert a human-readable checksum string in the text itself!  `^_^`
 
 ### Usage
 
-```<!---sh-->
+``` <!---sh-->
     ./omoikane <infile> <layout> <outfile>
 ```
 

2004/schnitzi/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./schnitzi <foo | vi -n
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -132,13 +132,13 @@ Try one of these methods to get the animation to run:
 
 1.  Redirect the output directly to vi, like this:
 
-```<!---sh-->
+``` <!---sh-->
     ./schnitzi < input.dat | vi
 ```
 
 2.  Redirect the output to a file, like this:
 
-```<!---sh-->
+``` <!---sh-->
     ./schnitzi < input.dat > output.dat
 ```
 

2004/sds/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -18,14 +18,14 @@ For more detailed information see [2004 sds bugs](../../bugs.html#2004_sds).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./sds
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -63,13 +63,13 @@ decoder.
 
 Try it out.  Compile the program, then type
 
-```<!---sh-->
+``` <!---sh-->
     ./sds < sds.c
 ```
 
 You should see the encoder program displayed.  Now save it, like:
 
-```<!---sh-->
+``` <!---sh-->
     ./sds < sds.c > encoder.c
 ```
 
@@ -82,14 +82,14 @@ standard input, and will output the results on the standard output.
 
 You can use it like this (assuming you have a file called remarks):
 
-```<!---sh-->
+``` <!---sh-->
     echo 'Hello, World!' > message
     ./encoder message < remarks > remarks_msg
 ```
 
 Then to decode:
 
-```<!---sh-->
+``` <!---sh-->
     ./sds < remarks_msg
     Hello, World!
 ```

2004/vik1/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik1 [arg]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik1
 
     ./vik1 a
@@ -82,7 +82,7 @@ Compile the source code and link X libraries if necessary.
 The program takes three options which have to be typed in a specific
 order as described below.
 
-```<!---sh-->
+``` <!---sh-->
     Usage: ./vik1 ['a']['d'][#]
 
     a   - Advanced racing in a winter landscape

2004/vik2/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./vik2
 ```
 
@@ -127,7 +127,7 @@ speed up the compilation, define the `STOP` symbol to anything from `_3` to
 `_10`. (The default value is `_10` which will make the compilation take some
 time.) Prime numbers up to `2^STOP` will be calculated.
 
-```<!---sh-->
+``` <!---sh-->
     cpp '-DSTOP=_5' '-DFNAME="tmp1.c"' prog.c tmp1.c
 ```
 
@@ -135,20 +135,20 @@ Then use `cpp` or any other
 [pre-processor](https://en.wikipedia.org/wiki/C_preprocessor) to do the actual
 work. This will take some time....
 
-```<!---sh-->
+``` <!---sh-->
     cpp tmp1.c > tmp2.c
 ```
 
 Finally compile the pre-processed file
 
-```<!---sh-->
+``` <!---sh-->
     cc -O tmp2.c -o prog
 ```
 
 Then run the program to reveal all prime numbers up to 32 (if you used
 `STOP=_5` as above):
 
-```<!---sh-->
+``` <!---sh-->
     ./vik2
 ```