fix links in 2020/ferguson1/troubleshooting.html

Ran `make gen_other_html` to perform the above.

2020/ferguson1/troubleshooting.html

@@ -141,20 +141,25 @@ or be a problem but actually are not. For each one I have included a summary, a
 more thorough description and any resolutions (from easiest to hardest). For
 anything that can cause more than one issue I will list those separately to keep
 it as structured as possible/easiest to find.</p>
-<p><a name="toc"></a>
+<div id="top">
-- <a href="#topwall">The top wall isn’t (all/some of the time) visible!</a>
+<ul>
-- <a href="#notmoving">The snake isn’t moving!</a>
+<li><a href="#topwall">The top wall isn’t (all/some of the time) visible!</a></li>
-- <a href="#invisiblehead">I can’t see the snake head (or other part of the snake)!</a>
+<li><a href="#notmoving">The snake isn’t moving!</a></li>
-- <a href="#invisiblebug">I can’t see the bug!</a>
+<li><a href="#invisiblehead">I can’t see the snake head (or other part of the snake)!</a></li>
-- <a href="#froze">The game froze!</a>
+<li><a href="#invisiblebug">I can’t see the bug!</a></li>
-- <a href="#bigsnake">The game gets slower as the snake gets bigger!</a>
+<li><a href="#froze">The game froze!</a></li>
-- <a href="#headonly">I set SIZE=0 GROW=1, ate a bug but still only the head was visible! Why?</a>
+<li><a href="#bigsnake">The game gets slower as the snake gets bigger!</a></li>
-- <a href="#monochrome">I like black text on a white background but even with a white background terminal it ends up black!</a>
+<li><a href="#headonly">I set SIZE=0 GROW=1, ate a bug but still only the head was visible! Why?</a></li>
-- <a href="#toodark">The text is hard to see (not bright enough)!</a>
+<li><a href="#monochrome">I like black text on a white background but even with a white background terminal it ends up black!</a></li>
-- <a href="#movefaster">Can I move the snake faster temporarily without having to modify the wait time?</a>
+<li><a href="#toodark">The text is hard to see (not bright enough)!</a></li>
-- <a href="#envvars">On environmental variables more generally and string to int conversions</a>
+<li><a href="#movefaster">Can I move the snake faster temporarily without having to modify the wait time?</a></li>
-- <a href="#errors">Errors and error reporting</a></p>
+<li><a href="#envvars">On environmental variables more generally and string to int conversions</a></li>
-<h2 id="the-top-wall-isnt-allsome-of-the-time-visible"><a name="topwall" href="#toc">The top wall isn’t (all/some of the time) visible!</a></h2>
+<li><a href="#errors">Errors and error reporting</a></li>
+</ul>
+</div>
+<div id="topwall">
+<h2 id="the-top-wall-isnt-allsome-of-the-time-visible"><a href="#toc">The top wall isn’t (all/some of the time) visible!</a></h2>
+</div>
 <p>Because the score line is dynamic in length depending on the terminal size it
 can happen that the score/status wraps to the next line(s). This can be fixed by
 modifying the status line (see <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/HACKING.html">HACKING.html</a> but
@@ -175,7 +180,9 @@ See the <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/f
 can include (though there are some discrepancies here and there as you’ll
 see).</p></li>
 </ul>
-<h2 id="the-snake-isnt-moving"><a name="notmoving" href="#toc">The snake isn’t moving!</a></h2>
+<div id="notmoving">
+<h2 id="the-snake-isnt-moving"><a href="#toc">The snake isn’t moving!</a></h2>
+</div>
 <p>Unless the game is paused this should not be happening. It can appear sometimes
 that there isn’t movement and sometimes it might have to take a moment to
 ‘unwind’ but as long as the head is moving then everything is fine.</p>
@@ -197,7 +204,9 @@ it’ll catch up; just give it the time it needs.</p></li>
 <li><p>BOTTOM LINE: If you want more information then see the <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/bugs.html">bugs.html</a>
 file.</p></li>
 </ul>
-<h2 id="i-cant-see-the-snake-head-or-other-part-of-the-snake"><a name="invisiblehead" href="#toc">I can’t see the snake head (or other part of the snake)!</a></h2>
+<div id="invisiblehead">
+<h2 id="i-cant-see-the-snake-head-or-other-part-of-the-snake"><a href="#toc">I can’t see the snake head (or other part of the snake)!</a></h2>
+</div>
 <p>Possibly this could happen with too long a score line which I already discussed.
 It also used to be possible during cannibal mode whilst cannibalising: you would
 just have to continue moving on and you’d eventually find your head (assuming
@@ -211,7 +220,9 @@ same time see it!</p></li>
 score line is covering the wall, snake and even bug; I gave two resolutions to
 that earlier in this file. To get a recommended number of columns use <code>make test</code>.</p></li>
 </ul>
-<h2 id="i-cant-see-the-bug"><a name="invisiblebug" href="#toc">I can’t see the bug!</a></h2>
+<div id="invisiblebug">
+<h2 id="i-cant-see-the-bug"><a href="#toc">I can’t see the bug!</a></h2>
+</div>
 <p>This has happened to me a number of times and early in development there were
 times that I could swear I even saw it beyond the walls but this should not be a
 problem now if it ever was.</p>
@@ -241,7 +252,9 @@ since <code>*</code> is a regexp metacharacter). This has happened to me numerou
 <li><p>RESOLUTION #3: If the colour contrast is not good for your eyes use the
 <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/snake-colours.sh">snake-colours.sh</a> script to select a different colour scheme.</p></li>
 </ul>
-<h2 id="the-game-froze"><a name="froze" href="#toc">The game froze!</a></h2>
+<div id="froze">
+<h2 id="the-game-froze"><a href="#toc">The game froze!</a></h2>
+</div>
 <p>This should not be possible either but without certain safety checks in place I
 have caused this (and I did this deliberately in development to find all the
 conditions I could to resolve them).</p>
@@ -305,7 +318,9 @@ then it’s <code>(maxy - 2) * (maxx - 2)</code>; above that would be:</p>
 kill the game by e.g. ctrl-c since the bug placement is stuck in a loop.
 This shouldn’t happen though.</p></li>
 </ul>
-<h2 id="the-game-gets-slower-as-the-snake-gets-bigger"><a name="bigsnake" href="#toc">The game gets slower as the snake gets bigger!</a></h2>
+<div id="bigsnake">
+<h2 id="the-game-gets-slower-as-the-snake-gets-bigger"><a href="#toc">The game gets slower as the snake gets bigger!</a></h2>
+</div>
 <p>Realistically the game shouldn’t take that much memory but maybe in some very
 busy systems it would have a problem.</p>
 <ul>
@@ -319,7 +334,9 @@ problem. Otherwise it would be good to see if you can find a pattern: is it when
 the snake is bigger i.e. the screen is rather fuller than when you first begin?
 Or is the system rather busy?</p></li>
 </ul>
-<h2 id="i-set-size0-grow1-ate-a-bug-but-still-only-the-head-was-visible-why"><a name="headonly" href="#toc">I set <code>SIZE=0 GROW=1</code>, ate a bug but still only the head was visible! Why?</a></h2>
+<div id="headonly">
+<h2 id="i-set-size0-grow1-ate-a-bug-but-still-only-the-head-was-visible-why"><a href="#toc">I set <code>SIZE=0 GROW=1</code>, ate a bug but still only the head was visible! Why?</a></h2>
+</div>
 <ul>
 <li><p>RESOLUTION #0: The size includes the head but what should it show if the size
 is 0? The head is the obvious choice so once you do get to size 1 you will still
@@ -334,7 +351,9 @@ you moving the head until you find a body to use! Once you have size &gt;= 2
 then cannibalism mode counts.</p></li>
 <li><p>BOTTOM LINE: In some senses SIZE=0 and SIZE=1 are the same thing.</p></li>
 </ul>
-<h2 id="i-like-black-text-on-a-white-background-but-even-with-a-white-background-terminal-it-ends-up-black"><a name="monochrome" href="#toc">I like black text on a white background but even with a white background terminal it ends up black!</a></h2>
+<div id="monochrome">
+<h2 id="i-like-black-text-on-a-white-background-but-even-with-a-white-background-terminal-it-ends-up-black"><a href="#toc">I like black text on a white background but even with a white background terminal it ends up black!</a></h2>
+</div>
 <p>This is a curses thing but fortunately it should be easy enough to solve.</p>
 <ul>
 <li><p>RESOLUTION #0: Try setting the terminal to monochrome for the invocation of
@@ -357,7 +376,9 @@ eat too many bytes in the entry (I cite the functions in the
 <p>I discuss colours and terminals in much more detail in
 <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/terminals.html">terminals.html</a>.</p></li>
 </ul>
-<h2 id="the-text-is-hard-to-see-not-bright-enough"><a name="toodark" href="#toc">The text is hard to see (not bright enough)!</a></h2>
+<div id="toodark">
+<h2 id="the-text-is-hard-to-see-not-bright-enough"><a href="#toc">The text is hard to see (not bright enough)!</a></h2>
+</div>
 <ul>
 <li><p>RESOLUTION #0: Make sure that your terminal settings have for bold text a
 brighter font. The way I have my terminal profiles set up is to use bright
@@ -370,7 +391,9 @@ you mess up your old one. FWIW I haven’t had this problem on consoles only
 and in my systems I have the option to enable brighter colours for bold - it
 was only in testing that I came across this problem.</p></li>
 </ul>
-<h2 id="can-i-move-the-snake-faster-temporarily-without-having-to-modify-the-wait-time"><a name="movefaster" href="#toc">Can I move the snake faster temporarily without having to modify the wait time?</a></h2>
+<div id="movefaster">
+<h2 id="can-i-move-the-snake-faster-temporarily-without-having-to-modify-the-wait-time"><a href="#toc">Can I move the snake faster temporarily without having to modify the wait time?</a></h2>
+</div>
 <p>Yes. The <code>getch()</code> call is non-blocking when the timeout value is positive so
 it’s up to that number of milliseconds.</p>
 <ul>
@@ -382,7 +405,9 @@ hit the key you can have more control over the speed - as long as it is quicker
 than the regular wait time. For negative wait time (drawing mode) you have to
 hit a key every time to move because it is blocking.</p></li>
 </ul>
-<h2 id="on-environmental-variables-more-generally-and-string-to-int-conversions"><a name="envvars" href="#toc">On environmental variables more generally and string to int conversions</a></h2>
+<div id="envvars">
+<h2 id="on-environmental-variables-more-generally-and-string-to-int-conversions"><a href="#toc">On environmental variables more generally and string to int conversions</a></h2>
+</div>
 <p>What happens if you do:</p>
 <pre><code>    WALLS= ./prog</code></pre>
 <p>Can you run into the wall since you didn’t specify a value and the default is 1?
@@ -421,7 +446,9 @@ example:</p>
 <p>I discuss the signed/unsigned issue to do with curses and sizes in C being
 unsigned in <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2020/ferguson1/bugs.html">bugs.html</a> but probably there isn’t
 anything more to say here.</p>
-<h2 id="errors-and-error-reporting"><a name="errors" href="#toc">Errors and error reporting</a></h2>
+<div id="errors">
+<h2 id="errors-and-error-reporting"><a href="#toc">Errors and error reporting</a></h2>
+</div>
 <p>If curses fails to initialise you should get an error that says ‘curses error’
 and you have every right to curse it to hell if that’s what you so wish.
 Apparently curses will report an error itself if that function fails but that

2020/ferguson1/troubleshooting.md

@@ -7,7 +7,7 @@ more thorough description and any resolutions (from easiest to hardest). For
 anything that can cause more than one issue I will list those separately to keep
 it as structured as possible/easiest to find.
 
-<a name="toc"></a>
+<div id="top">
 -   [The top wall isn't (all/some of the time) visible!](#topwall)
 -   [The snake isn't moving!](#notmoving)
 -   [I can't see the snake head (or other part of the snake)!](#invisiblehead)
@@ -20,9 +20,12 @@ it as structured as possible/easiest to find.
 -   [Can I move the snake faster temporarily without having to modify the wait time?](#movefaster)
 -   [On environmental variables more generally and string to int conversions](#envvars)
 -   [Errors and error reporting](#errors)
+</div>
 
 
-## <a name="topwall" href="#toc">The top wall isn't (all/some of the time) visible!</a>
+<div id="topwall">
+## <a href="#toc">The top wall isn't (all/some of the time) visible!</a>
+</div>
 
 Because the score line is dynamic in length depending on the terminal size it
 can happen that the score/status wraps to the next line(s). This can be fixed by
@@ -53,7 +56,9 @@ you shouldn't need it to be very wide.
     see).
 
 
-## <a name="notmoving" href="#toc">The snake isn't moving!</a>
+<div id="notmoving">
+## <a href="#toc">The snake isn't moving!</a>
+</div>
 
 Unless the game is paused this should not be happening. It can appear sometimes
 that there isn't movement and sometimes it might have to take a moment to
@@ -84,7 +89,9 @@ e.g. when the snake is growing.
 file.
 
 
-## <a name="invisiblehead" href="#toc">I can't see the snake head (or other part of the snake)!</a>
+<div id="invisiblehead">
+## <a href="#toc">I can't see the snake head (or other part of the snake)!</a>
+</div>
 
 Possibly this could happen with too long a score line which I already discussed.
 It also used to be possible during cannibal mode whilst cannibalising: you would
@@ -102,7 +109,9 @@ that earlier in this file. To get a recommended number of columns use `make
 test`.
 
 
-## <a name="invisiblebug" href="#toc">I can't see the bug!</a>
+<div id="invisiblebug">
+## <a href="#toc">I can't see the bug!</a>
+</div>
 
 This has happened to me a number of times and early in development there were
 times that I could swear I even saw it beyond the walls but this should not be a
@@ -139,7 +148,9 @@ since `*` is a regexp metacharacter). This has happened to me numerous times.
 [snake-colours.sh][] script to select a different colour scheme.
 
 
-## <a name="froze" href="#toc">The game froze!</a>
+<div id="froze">
+## <a href="#toc">The game froze!</a>
+</div>
 
 This should not be possible either but without certain safety checks in place I
 have caused this (and I did this deliberately in development to find all the
@@ -226,7 +237,9 @@ snake. See below for some tests.
     This shouldn't happen though.
 
 
-## <a name="bigsnake" href="#toc">The game gets slower as the snake gets bigger!</a>
+<div id="bigsnake">
+## <a href="#toc">The game gets slower as the snake gets bigger!</a>
+</div>
 
 Realistically the game shouldn't take that much memory but maybe in some very
 busy systems it would have a problem.
@@ -244,7 +257,9 @@ the snake is bigger i.e. the screen is rather fuller than when you first begin?
 Or is the system rather busy?
 
 
-## <a name="headonly" href="#toc">I set `SIZE=0 GROW=1`, ate a bug but still only the head was visible! Why?</a>
+<div id="headonly">
+## <a href="#toc">I set `SIZE=0 GROW=1`, ate a bug but still only the head was visible! Why?</a>
+</div>
 
 * RESOLUTION #0: The size includes the head but what should it show if the size
 is 0? The head is the obvious choice so once you do get to size 1 you will still
@@ -264,7 +279,9 @@ Try:
 * BOTTOM LINE: In some senses SIZE=0 and SIZE=1 are the same thing.
 
 
-## <a name="monochrome" href="#toc">I like black text on a white background but even with a white background terminal it ends up black!</a>
+<div id="monochrome">
+## <a href="#toc">I like black text on a white background but even with a white background terminal it ends up black!</a>
+</div>
 
 This is a curses thing but fortunately it should be easy enough to solve.
 
@@ -294,7 +311,9 @@ so that's probably why; in CentOS I did have to install it specially.
     [terminals.html][].
 
 
-## <a name="toodark" href="#toc">The text is hard to see (not bright enough)!</a>
+<div id="toodark">
+## <a href="#toc">The text is hard to see (not bright enough)!</a>
+</div>
 
 * RESOLUTION #0: Make sure that your terminal settings have for bold text a
 brighter font. The way I have my terminal profiles set up is to use bright
@@ -308,7 +327,10 @@ out if enabling brighter colours is possible.
     and in my systems I have the option to enable brighter colours for bold - it
     was only in testing that I came across this problem.
 
-## <a name="movefaster" href="#toc">Can I move the snake faster temporarily without having to modify the wait time?</a>
+
+<div id="movefaster">
+## <a href="#toc">Can I move the snake faster temporarily without having to modify the wait time?</a>
+</div>
 
 Yes. The `getch()` call is non-blocking when the timeout value is positive so
 it's up to that number of milliseconds.
@@ -323,8 +345,9 @@ than the regular wait time. For negative wait time (drawing mode) you have to
 hit a key every time to move because it is blocking.
 
 
-
+<div id="envvars">
-## <a name="envvars" href="#toc">On environmental variables more generally and string to int conversions</a>
+## <a href="#toc">On environmental variables more generally and string to int conversions</a>
+</div>
 
 What happens if you do:
 
@@ -398,7 +421,10 @@ I discuss the signed/unsigned issue to do with curses and sizes in C being
 unsigned in [bugs.html][] but probably there isn't
 anything more to say here.
 
-## <a name="errors" href="#toc">Errors and error reporting</a>
+
+<div id="errors">
+## <a href="#toc">Errors and error reporting</a>
+</div>
 
 If curses fails to initialise you should get an error that says 'curses error'
 and you have every right to curse it to hell if that's what you so wish.