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.

2006/birken/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -18,14 +18,14 @@ For more detailed information see [2006 birken bugs](../../bugs.html#2006_birken
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./birken < file.tofu
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 

2006/borsanyi/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -18,14 +18,14 @@ For more detailed information see [2006 borsanyi bugs](../../bugs.html#2006_bors
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./borsanyi string > file.gif
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -68,7 +68,7 @@ used. A typical email address is stored in less than 1-2 kilobytes.
 
 ### Usage:
 
-```<!---sh-->
+``` <!---sh-->
     make all
     ./borsanyi my@example.com > email.gif
     my_favourite_gif_viewer email.gif

2006/grothe/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./grothe carrier_freq pixelclock horizontal_total < some_input.txt
 ```
 
@@ -16,7 +16,7 @@
 
 Put on your "electronic ears" and then try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -50,13 +50,13 @@ parameters:
 If you have `xvidtune` installed you can get the `pixelclock` and
 `horizontal_total` with the following command
 
-```<!---sh-->
+``` <!---sh-->
     xvidtune -show | head -n 1 | awk '{ print "pixelclock " $2 * 1000000 " horizontal_total = " $6 }'
 ```
 
 Example from my laptops:
 
-```<!---sh-->
+``` <!---sh-->
     ./grothe 65000000 10000000 1344 < twinkle.txt
 ```
 

2006/hamre/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./hamre math_expression_string
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -42,7 +42,7 @@ supported operators are: `+`, `-` (binary and unary), `*`, `/` and `()`. Run it
 by supplying an expression as the first argument, and the normalized
 result will be written to `stdout`.
 
-```<!---sh-->
+``` <!---sh-->
     ./hamre '-1+4/3*(2+1/(3/2*(7/2-7/3+1/6)))/2'
     2/3
 ```

2006/meyer/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./meyer [SEED]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./meyer [SEED]
 ```
 
@@ -75,7 +75,7 @@ you write is what it does'). It may be tempting to think that
 
 might do something similar as
 
-```<!---c-->
+``` <!---c-->
     struct not_an_object o;
 ```
 
@@ -100,7 +100,7 @@ implementation in a popular object-oriented programming language.
 
 ### Starting the game
 
-```<!---sh-->
+``` <!---sh-->
     ./meyer [SEED]
 ```
 

2006/monge/README.md

@@ -2,7 +2,7 @@
 
 Make sure you have the SDL1 (not SDL2!) development environment installed.
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -24,7 +24,7 @@ For more detailed information see [2006 monge bugs](../../bugs.html#2006_monge).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge expression ...
 ```
 
@@ -33,7 +33,7 @@ Incorrect formulas will ungracefully crash the program.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -49,7 +49,7 @@ as the number of iterations to perform.
 To use the default values, the same as [monge.c](monge.c), just do:
 
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -58,13 +58,13 @@ of the variables `W`, `H` and `I`. The defaults are (respectively) 400, 300 and
 \128. If you wish to change the image size to 500x500 but keep the iterations
 the same then do:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber WIDTH=500 HEIGHT=500 alt
 ```
 
 If you wish to keep the dimensions the same but change the iterations to 512:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber ITERATIONS=512 alt
 ```
 
@@ -82,7 +82,7 @@ Use `monge.alt` exactly as you would `monge` above.
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.alt.sh
 ```
 
@@ -109,13 +109,13 @@ effort to work on both `i386` and `x86_64`. Portable it is! :)
 
 0. Compile using the Makefile, or just run:
 
-```<!---sh-->
+``` <!---sh-->
     gcc monge.c -o monge -O3 `sdl-config --libs --cflags`
 ```
 
 1. Run:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z = 0" "z = z*z + c; Abs2(z) < 4"
 ```
 
@@ -171,49 +171,49 @@ Here are a few examples of fractals you can draw:
 
 - Mandelbrot:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=1" "z=z*z+c; Abs2(z)<4"
 ```
 
 - Mandelbrot (return time variation):
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=c" "z=z*z+c; Abs2(z-c)>0.0001"
 ```
 
 - Julia, for `c=0.31+i*0.5`:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=c; c=0.31+i*0.5" "z=z*z+c; Abs2(z)<4"
 ```
 
 - Julia (return time variation), `for c=0.31+i*0.5`:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=c; c=0.31+i*0.5" "z=z*z+c; Abs2(z-c)>0.0001"
 ```
 
 - Newton, for `x^3-1`:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=c" "p=z; z=0.6666*z+0.3333/(z*z); Abs2(p-z) > 0.001"
 ```
 
 - Newton-Mandelbrot:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=0" "p=z; z=z-(z*z*z + (c-1)*z - c)/(3*z*z+c-1); Abs2(p-z) > 0.001"
 ```
 
 - Phoenix, Mandelbrot version:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=0; q=0" "t=z; z=z*z+Re(c)+Im(c)*q; q=t; Abs2(z)<4"
 ```
 
 - Phoenix, Julia version for `c=0.56667-i*0.5`:
 
-```<!---sh-->
+``` <!---sh-->
     ./monge "z=c; c=0.56667-i*0.5; q=0" "t=z; z=z*z+Re(c)+Im(c)*q; q=t; Abs2(z)<4"
 ```
 

2006/night/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -10,7 +10,7 @@ code](#alternate-code) section below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./night
 ```
 
@@ -23,7 +23,7 @@ keys.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -129,7 +129,7 @@ to deobfuscate.
 Keypad support was removed to save space. To restore, modify the
 following two macros to:
 
-```<!---c-->
+``` <!---c-->
     #define ATG srand(time(0)); initscr(); cbreak(); noecho(); start_color(); keypad(stdscr,1);
     #define AGG A&2?KEY_UP:KEY_DOWN:A&1?KEY_RIGHT:KEY_LEFT
 ```

2006/sloane/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -11,7 +11,7 @@ code](#original-code) below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./slone.alt
 ```
 
@@ -24,7 +24,7 @@ problematic for some people, can be configured to different speeds by way of the
 value used in `usleep()`. The default is `75000` but you can easily change
 it. To do so try:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber SLEEP=70000 clobber alt
     ./sloane.alt
 ```
@@ -32,7 +32,7 @@ it. To do so try:
 If you wish to make it like the original, as if the below [Original
 code](#original-code) was being used, you can do:
 
-```<!---sh-->
+``` <!---sh-->
     make SLEEP=0 clobber alt
     ./sloane.alt
 ```
@@ -46,14 +46,14 @@ Should you wish to see the original you may do so with the original code,
 
 ### Original build:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber all
 ```
 
 
 ### Original use:
 
-```<!---sh-->
+``` <!---sh-->
     ./sloane
 ```
 

2006/stewart/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./stewart width_and_height iterations file > file.xbm
     convert file.xbm file.png
 ```
@@ -29,7 +29,7 @@ NOTE: `convert(1)` belongs to [ImageMagick](https://imagemagick.org/index.php).
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -58,7 +58,7 @@ a reasonably experienced user who can parse formats in their mind.  :-)
 
 The program should be run with the following
 
-```<!---sh-->
+``` <!---sh-->
     ./stewart <m> <n> <ifs>
 ```
 
@@ -77,7 +77,7 @@ are 3.  Wrong arguments will cause the program to bomb out.
 
 #### Example:
 
-```<!---sh-->
+``` <!---sh-->
     ./stewart 1024 1000000 gasket > gasket.xbm
 ```
 

2006/sykes1/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -22,7 +22,7 @@ For more detailed information see [2006 sykes1 bugs](../../bugs.html#2006_sykes1
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes1
 ```
 
@@ -31,7 +31,7 @@ Next point your browser to the file: `sykes1.html`.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes1 10
 ```
 
@@ -39,7 +39,7 @@ Refresh your browser.
 
 You might also try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -52,7 +52,7 @@ If you have all day :-) and wish to find out how fast your machine can solve the
 maximum:
 
 
-```<!---sh-->
+``` <!---sh-->
     time ./sykes1 19186
 ```
 
@@ -81,7 +81,7 @@ This alternate code is based on the author's remarks.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -96,7 +96,7 @@ Use `sykes1.alt` as you would `sykes1` above.
 The [try.sh](try.sh) script will use both versions to show some differences. You
 can do so like:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -106,7 +106,7 @@ can do so like:
 Read the [sykes1.html](sykes1.html) page source.
 Now then read the C source.  Confused?  :-) If it's not clear try:
 
-```<!---sh-->
+``` <!---sh-->
     diff -s sykes1.c sykes1.html
 ```
 
@@ -138,7 +138,7 @@ need to be very lucky indeed to stumble across a solution.
 
 Compile the program, then test that it works:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes1
 ```
 
@@ -154,7 +154,7 @@ cube.  Rendered in glorious 3D color.
 
 Want to see another solution?  Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes1 some_number
 ```
 
@@ -165,7 +165,7 @@ Try some more - there are exactly `19186` solutions to choose from.
 
 If you have a fast machine you might try the last solution:
 
-```<!---sh-->
+``` <!---sh-->
     ./sykes1 19186
 ```
 
@@ -178,7 +178,7 @@ The implementation is an optimized recursive algorithm that tries to fit
 the pieces into the cube one by one.  The cube pieces are defined near
 the start of the program:
 
-```<!---c-->
+``` <!---c-->
     int s[ ] = { 186, 94, 1426, 3098
 	    ,1047 , 122 , 1082 , 3083 , 1039
 	    , 569 , 527 , 1054 , 531  }  ;
@@ -233,7 +233,7 @@ the pieces, and provided that a solution is possible, it will be found.
 For example, if you modify line 13 of the source like this, the program
 will solve for a different piece set:
 
-```<!---c-->
+``` <!---c-->
     int s[ ] = { 187, 94, 402, 3098
 ```
 

2006/sykes2/README.md

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

2006/toledo1/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo1 [0-9][0-9]
 ```
 
@@ -16,7 +16,7 @@ where `[0-9][0-9]` is a two digit number.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -38,7 +38,7 @@ visit the 64 squares without repeating them?
 If not, this program does it, just run it with an argument
 giving initial position.
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo1 11       # start is A8
     ./toledo1 18       # start is H8
     ./toledo1 81       # start is A1

2006/toledo2/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -22,7 +22,7 @@ For more detailed information see [2006 toledo2 bugs](../../bugs.html#2006_toled
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo2
 ```
 
@@ -33,7 +33,7 @@ does not seem to happen in macOS or linux in 2023.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo2
 ```
 
@@ -56,7 +56,7 @@ functions in place of `read(2)` and `write(2)`.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -112,7 +112,7 @@ Journal](https://en.wikipedia.org/wiki/Dr._Dobb%27s_Journal).
 Type using uppercase letters. Here are three example programs. Press Enter after
 each line:
 
-```<!---basic-->
+``` <!---basic-->
     10 PRINT "Hello, world!"
     LIST
     RUN
@@ -155,7 +155,7 @@ from the `SOURCE` directory:
 To import them, you must run the emulator with an argument, by
 example:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo2 DDT.COM
 ```
 

2006/toledo3/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -11,14 +11,14 @@ tested with Windows.  See [alternate code](#alternate-code) below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo3 [1 | 2 | 3 [b]]
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo3 1
 ```
 
@@ -62,7 +62,7 @@ So I managed to do a graphical X11 chess program ('`WYSIAIE`', or 'What You See
 Is An IOCCC Entry'). Pointing and clicking to move pieces is the only required
 action, and of course the command-line options:
 
-```<!---sh-->
+``` <!---sh-->
     ./toledo3        # Two-players mode (useful if you don't have a board at hand)
     ./toledo3 1      # Human white - Computer black, level 1 (fast)
     ./toledo3 2      # Human white - Computer black, level 2 (medium)
@@ -97,7 +97,7 @@ number generator.
 Because it is resource-hungry, I strongly recommend to compile it
 using maximum optimization. With GCC you can use:
 
-```<!---sh-->
+``` <!---sh-->
     gcc -O3 -fexpensive-optimizations prog.c -o prog -lX11
 ```