mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix links in 2020/ferguson1/troubleshooting.html

Browse Source 
Ran `make gen_other_html` to perform the above.
This commit is contained in:
Landon Curt Noll committed 2024-04-21 23:06:57 -07:00
1 parent d51c4686fc
commit de89744391
2 files changed
+92 -39
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2020/ferguson1/troubleshooting.html
+52 -25
View File
@@ -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>
- <a href="#topwall">The top wall isn’t (all/some of the time) visible!</a>
- <a href="#notmoving">The snake isn’t moving!</a>
- <a href="#invisiblehead">I can’t see the snake head (or other part of the snake)!</a>
- <a href="#invisiblebug">I can’t see the bug!</a>
- <a href="#froze">The game froze!</a>
- <a href="#bigsnake">The game gets slower as the snake gets bigger!</a>
- <a href="#headonly">I set SIZE=0 GROW=1, ate a bug but still only the head was visible! Why?</a>
- <a href="#monochrome">I like black text on a white background but even with a white background terminal it ends up black!</a>
- <a href="#toodark">The text is hard to see (not bright enough)!</a>
- <a href="#movefaster">Can I move the snake faster temporarily without having to modify the wait time?</a>
- <a href="#envvars">On environmental variables more generally and string to int conversions</a>
- <a href="#errors">Errors and error reporting</a></p>
<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>
<div id="top">
<ul>
<li><a href="#topwall">The top wall isn’t (all/some of the time) visible!</a></li>
<li><a href="#notmoving">The snake isn’t moving!</a></li>
<li><a href="#invisiblehead">I can’t see the snake head (or other part of the snake)!</a></li>
<li><a href="#invisiblebug">I can’t see the bug!</a></li>
<li><a href="#froze">The game froze!</a></li>
<li><a href="#bigsnake">The game gets slower as the snake gets bigger!</a></li>
<li><a href="#headonly">I set SIZE=0 GROW=1, ate a bug but still only the head was visible! Why?</a></li>
<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>
<li><a href="#toodark">The text is hard to see (not bright enough)!</a></li>
<li><a href="#movefaster">Can I move the snake faster temporarily without having to modify the wait time?</a></li>
<li><a href="#envvars">On environmental variables more generally and string to int conversions</a></li>
<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
+40 -14
View File
@@ -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.
## <a name="envvars" href="#toc">On environmental variables more generally and string to int conversions</a>
<div id="envvars">
## <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.