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.

2014/birken/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -11,7 +11,7 @@ there is a firewall issue, and also lets you redefine the timing constant,
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < some_secret_or_something
 
     ./prog http://host[:port]
@@ -20,19 +20,19 @@ there is a firewall issue, and also lets you redefine the timing constant,
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < README.md
 ```
 
 or maybe:
 
-```<!---sh-->
+``` <!---sh-->
     echo "IOCCC 2014!" | ./prog
 ```
 
 Next, try in another terminal, as the above one is running:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog http://127.0.0.1:1701
 ```
 
@@ -55,13 +55,13 @@ described by the author. See [configuration](#configuration) below.
 
 To specify the port to say, 31337, try:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber PORT=31337 alt
 ```
 
 To change the timing constant, `STARDATE`, try:
 
-```<!---sh-->
+``` <!---sh-->
     make clobber TIME=5000000 alt
 ```
 
@@ -101,26 +101,26 @@ the server.
 
 ## To use web server
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < secret_file_to_be_downloaded
 ```
 
 Try using the program's source code as the secret file:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < prog.c
 ```
 
 ## To use client-side downloader
 
-```<!---sh-->
+``` <!---sh-->
     ./prog http://host[:port]
 ```
 
 The optional port defaults to 1701.  If the web server instance is started on
 the same box, try:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog http://127.0.0.1:1701
 ```
 
@@ -246,7 +246,7 @@ numerical values.
 For space considerations, the following include statements were dropped
 resulting in compiler warnings:
 
-```<!---c-->
+``` <!---c-->
     #include <asm/byteorder.h>
     #include <ctype.h>
     #include <netinet/in.h>

2014/deak/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -12,14 +12,14 @@ code](#alternate-code) below.
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog
 ```
 
@@ -36,7 +36,7 @@ recognisable and also to let you reconfigure the coordinates.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -45,7 +45,7 @@ If you wish to redefine the coordinates you can do so by defining `X1`, `X2`,
 For instance:
 
 
-```<!---sh-->
+``` <!---sh-->
     make clobber X1=-3 X2=2 Y1=-2.3 Y2=2.3 alt
 ```
 
@@ -59,7 +59,7 @@ Use `prog.alt` as you would `prog`.
 
 ### Alternate try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.alt.sh
 ```
 
@@ -94,7 +94,7 @@ The usage of recognizable elements from the C programming language in the
 application source code is intentionally kept to a bare minimum. If this phrase
 would not be true, the application would be the following:
 
-```<!---c-->
+``` <!---c-->
     double                                 _[]={-2
     ,1,-1.3                ,1.3,  0,         0,0,0
     ,0               ,0,50, 80,     0,0,0     ,255

2014/endoh1/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog > foo.c
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -36,14 +36,14 @@ What is the difference between running `./prog` and `main`?
 Big terminals with tiny fonts have their uses in certain cases.
 One of them is:
 
-```<!---sh-->
+``` <!---sh-->
     make treacl
     ./treacl
 ```
 
 which is shorthand for:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < prog.c > treacle.c
     make treacle
     ./treacle

2014/endoh1/spoilers.md

@@ -18,7 +18,7 @@ Do you think that it is possible to write QR code encoder in C within *1kB*?
 It is known that we can mitigate the quine restriction by `eval`.
 For example, this is a quine written in Ruby:
 
-```<!---ruby-->
+``` <!---ruby-->
     eval s="print 'eval s='; p s"
 ```
 
@@ -122,7 +122,7 @@ The compiler tool chain is the following.
 
 You can run the process by `rake` command.  `ruby-minisat` gem is needed.
 
-```<!---sh-->
+``` <!---sh-->
     $ gem install ruby-minisat
     $ rake
 ```
@@ -145,7 +145,7 @@ but it appears to no longer exist.
 
 You can use [tool.rb](tool.rb) to convert the output to a png file.
 
-```<!---sh-->
+``` <!---sh-->
     ./main Hello | ruby tool.rb > hello.png
 
     $ zbarimg -q hello.png

2014/endoh2/README.md

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

2014/maffiodo1/README.md

@@ -3,7 +3,7 @@
 This entry requires SDL to be installed. See [FAQ 3.8](../../faq.html#SDL) if you
 don't know how to do this for your system.
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -21,7 +21,7 @@ For more detailed information see [2014 maffiodo1 bugs](../../bugs.html#2014_maf
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     cat game.level | ./prog 320 200 800 300 128 144 game.rgba game.wav 10343679
 ```
 
@@ -41,7 +41,7 @@ note on macOS.
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./giana.sh
 
     ./mario.sh
@@ -61,7 +61,7 @@ try:
 If you wish to change the width and height, defaulting at 640 x 480, say to
 800 x 800, try:
 
-```<!---sh-->
+``` <!---sh-->
     ROWS=800 COLS=800 ./mario.sh
 
     ROWS=800 COLS=800 ./giana.sh
@@ -92,14 +92,14 @@ immediately take effect.
 
 Use `tabsize=4` to see the magic.
 
-```<!---sh-->
+``` <!---sh-->
     expand -t 4 prog.c
 ```
 
 The program returns 0 if the player wins or *non-zero* if the player loses so
 you can test it and make something useful (or not), like this:
 
-```<!---sh-->
+``` <!---sh-->
     cat mario.level | ./prog 320 200 800 300 128 144 mario.rgba mario8.wav 10343679 && telnet telehack.com 23
 ```
 
@@ -228,7 +228,7 @@ You can input as many objects as you want but the maximum number of objects
 handled by the program is 333. You can modify this value by editing the source
 here:
 
-```<!---c-->
+``` <!---c-->
     C[333*7],d=333;
 ```
 

2014/maffiodo2/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -21,14 +21,14 @@ For more detailed information see [2014 maffiodo2 bugs](../../bugs.html#2014_maf
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog arg
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -41,14 +41,14 @@ as fun but it's 121 bytes instead of 140.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
 
 ### Alternate use:
 
-```<!---sh-->
+``` <!---sh-->
     cat image.rgb | ./prog.alt
 ```
 
@@ -91,7 +91,7 @@ The program will crash if run without parameters.
 If you have a terminal geometry than is different from the common 80x25 you can
 modify the *output width* by changing the value of the first variable:
 
-```<!---c-->
+``` <!---c-->
     d=80,
 ```
 
@@ -99,14 +99,14 @@ modify the *output width* by changing the value of the first variable:
 
 Type this:
 
-```<!---sh-->
+``` <!---sh-->
     cat image.rgb | ./prog "  .:;Y0"
 ```
 
 You can use your own image. Convert the image to a raw RGB image. Using
 ImageMagick it's very simple:
 
-```<!---sh-->
+``` <!---sh-->
     convert -geometry 80x source.jpg image.rgb
 ```
 
@@ -116,7 +116,7 @@ program is the *conversion ramp*. You can use different ramps or create your own
 
 These are some ramps you can try:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog " :1"
     ./prog "  .:;Y0"
     ./prog " .:-=+*#%@"
@@ -127,7 +127,7 @@ These are some ramps you can try:
 
 An alternative version of this program is only 121bytes long:
 
-```<!---c-->
+``` <!---c-->
     d=80,e,j;g(){j+=getchar();}main(){for(;;){j=0;g();if(j<0)break;g(g());putchar(" .:#@"[j/3*5>>8]);if(!(++e%d))puts("");}}
 ```
 

2014/morgan/README.md

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

2014/sinon/README.md

@@ -1,13 +1,13 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./hecate.sh
 
     ./glock.sh
@@ -16,7 +16,7 @@
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -41,7 +41,7 @@ under one minute.
 To start, compile and run the program.  To resume, compile and run the
 output repeatedly until you have won/lost the game.  For example:
 
-```<!---sh-->
+``` <!---sh-->
     cp prog.c run.c
     gcc -O0 run.c -o run && ./run | tee run.c
     gcc -O2 run.c -o run && ./run | tee run.c
@@ -106,7 +106,7 @@ a primary input.
 that there are no files named "run" and "run.c" in current directory
 (they will be overwritten) and run:
 
-```<!---sh-->
+``` <!---sh-->
     perl prog.c | bash
 ```
 

2014/skeggs/README.md

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

2014/vik/README.md

@@ -1,6 +1,6 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
@@ -22,7 +22,7 @@ For more detailed information see [2014 vik bugs](../../bugs.html#2014_vik).
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     echo foo | ./prog > audio_file.raw
 
     echo foo | ./prog | mplayer -demuxer rawaudio -
@@ -31,7 +31,7 @@ For more detailed information see [2014 vik bugs](../../bugs.html#2014_vik).
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -44,7 +44,7 @@ instructions on how to get it to work with Windows.
 
 ### Alternate build:
 
-```<!---sh-->
+``` <!---sh-->
     make alt
 ```
 
@@ -59,13 +59,13 @@ Use `prog.alt` as you would `prog` above as well as below.
 This program sets a new tone for obfuscation. But do you understand
 what it says about obfuscation? Perhaps:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < prog.c > prog.raw
 ```
 
 might speak to your coding style? If not, then perhaps:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog < README.md | mplayer -demuxer rawaudio -
 ```
 
@@ -87,7 +87,7 @@ Don't forget the last '`-`' as it makes `mplayer(1)` read from `stdin`.
 
 ## Convert audio file with Morse signals to text
 
-```<!---sh-->
+``` <!---sh-->
     ./prog e < audio_file.raw
 ```
 
@@ -106,7 +106,7 @@ Microsoft compilers add a carriage return to newlines, and to compile the
 program with this platform, the following line can be added to `main()` before
 any code in order for the program to run correctly:
 
-```<!---c-->
+``` <!---c-->
     _setmode(_fileno(stdout), 0x8000);
 ```
 

2014/wiedijk/README.md

@@ -1,20 +1,20 @@
 ## To build:
 
-```<!---sh-->
+``` <!---sh-->
     make
 ```
 
 
 ## To use:
 
-```<!---sh-->
+``` <!---sh-->
     ./prog
 ```
 
 
 ## Try:
 
-```<!---sh-->
+``` <!---sh-->
     ./try.sh
 ```
 
@@ -22,7 +22,7 @@ By default that will use `indent(1)` found by the shell `type -P indent` and
 `sed(1)` found by the shell `type -P sed` but if you want to change these, say
 to try a different beautifier, you can do it like:
 
-```<!---sh-->
+``` <!---sh-->
     INDENT=bcpp ./try.sh
 ```