Landon Curt Noll
c1466f5165
Updated manifest as per recent file changes. Updated winner `.winner.json` to reflect the manifest changes. Added [bin/all_run.sh](bin/all_run.sh) tool to run a command over all winning entries. These tools had slight improvements in the help usage message: * bin/gen-author.sh VERSION="1.3.1 2024-01-16" * bin/gen-inventory.sh VERSION="1.0.1 2024-01-16" * bin/pandoc_wrapper.sh VERSION="1.3.1 2024-01-16" * bin/subst.default.sh VERSION="1.1.1 2024-01-16" * bin/subst.winner-index.sh VERSION="1.1.1 2024-01-16" The `bin/readme2index.sh` tool was improved so that if the `index.html` file exists and the tool forms the exact same content, then the file `index.html` file is NOT touched. * bin/readme2index.sh VERSION="1.1 2024-01-16" We used the following command to generate `index.html` files for all winning entries: ```sh bin/all_run.sh -v 3 bin/readme2index.sh ``` NOTE: We have not (yet) built HTML files above the winner directory level (e.g., no year level nor top level HTML), nor have be built non-index HTML files for winners. NOTE: By default we are running `pandoc(1)` with: ``` --fail-if-warnings=true ``` This means that any problems with markdown to HTML generates an error. This is done to be sure that the HTML conversion is clean. We had to fix the following `README.md` files: * `2000/rince/README.md` The reference [^2] was never used. We made a guess that [^2] applies to the same spot as [^1]. Perhaps there is a better spot where [^2] applies? NOTE: For every reference, there MUST be some place where that reference is used. * 2012/vik/README.md The string "$...$" is assumed to be a TeX encoded string. NOTE: Every "$..$" needs to be backslashed as in "\$..\$". * 2018/burton1/README.md The reference [2] was duplicated. We changed the second [2] to [3]. NOTE: Every reference needs to have a unique number. * 2020/carlini/README.md The string "$...$" is assumed to be a TeX encoded string. NOTE: Every "$..$" needs to be backslashed as in "\$..\$". We also found 2 errors in the `author/author_handle.json` file set: * author/Anonymous_2001.json The `author/Anonymous_2001.json` file was missing. * author/Jari_Arkko.json The winner ID for `1989_jar.1` had a typo.
291 lines
13 KiB
HTML
291 lines
13 KiB
HTML
<!DOCTYPE html>
|
||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
||
<!-- START: two lines up starts content from: inc/top.default.html -->
|
||
<!-- -->
|
||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||
<!-- !!! DO NOT MODIFY THIS FILE - This file is generated by a tool !!! -->
|
||
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
|
||
<!-- -->
|
||
<!-- END: this line ends content from: inc/top.default.html -->
|
||
<!-- -->
|
||
<!-- This file was formed by the tool: bin/readme2index.sh version: 1.1 2024-01-16 -->
|
||
<!-- -->
|
||
<!-- START: this line starts content from: inc/head.default.html -->
|
||
|
||
<head>
|
||
<link rel="stylesheet" href="/temp-test-ioccc/ioccc.css">
|
||
<meta charset="utf-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||
<title>1992/kivinen</title>
|
||
<meta name="description" content="1992 IOCCC winner kivinen">
|
||
<meta name="keywords" content="IOCCC, 1992, IOCCC 1992, IOCCC winner, kivinen">
|
||
</head>
|
||
|
||
<!-- END: this line ends content from: inc/head.default.html -->
|
||
<!-- START: this line starts content from: inc/body.default.html -->
|
||
|
||
<body>
|
||
|
||
<!-- END: this line ends content from: inc/body.default.html -->
|
||
<!-- START: this line starts content from: inc/header.default.html -->
|
||
|
||
<div class="header">
|
||
<img src="/temp-test-ioccc/png/ioccc.png" alt="IOCCC image by Matt Zucker" width=300 height=110>
|
||
<h1>The International Obfuscated C Code Contest</h1>
|
||
<h2>1992/kivinen</h2>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/header.default.html -->
|
||
<!-- START: this line starts content from: inc/topnav.mid.html -->
|
||
|
||
<div class="topnav">
|
||
<a class="Left" href="../imc/index.html">← imc</a>
|
||
<a class="Left" href="../index.html">↑ 1992 ↑</a>
|
||
<a class="Left" href="../lush/index.html">lush →</a>
|
||
<a class="Right" href="#inventory">Inventory</a>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/topnav.mid.html -->
|
||
<!-- START: this line starts content from: inc/begin-row.default.html -->
|
||
|
||
<div class="row">
|
||
|
||
<!-- END: this line ends content from: inc/begin-row.default.html -->
|
||
<!-- START: this line starts content from: inc/begin-leftcolumn.default.html -->
|
||
|
||
<div class="leftcolumn">
|
||
|
||
<!-- END: this line ends content from: inc/begin-leftcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/sidenav.default.html -->
|
||
|
||
<div class="sidenav">
|
||
<a href="#content">Jump to contents</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="/temp-test-ioccc/index.html">IOCCC Home</a>
|
||
<a href="/temp-test-ioccc/years.html">Winning Entries</a>
|
||
<a href="/temp-test-ioccc/winners.html">People who have won</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="/temp-test-ioccc/news.html">IOCCC News</a>
|
||
<a href="/temp-test-ioccc/faq.html#submit">How to enter the IOCCC</a>
|
||
<a href="/temp-test-ioccc/faq.html">FAQ</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="/temp-test-ioccc/bugs.html">Bugs & (mis)features</a>
|
||
<a href="/temp-test-ioccc/faq.html#fix_a_winner">Fixing IOCCC winners</a>
|
||
<a href="/temp-test-ioccc/faq.html#fix_web_site">Fixing the web site</a>
|
||
<a href="/temp-test-ioccc/faq.html#fix_author">Fixing winner info</a>
|
||
<a href="/temp-test-ioccc/thanks-for-help.html">Thanks for the help</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="/temp-test-ioccc/judges.html">The IOCCC Judges</a>
|
||
<a href="/temp-test-ioccc/contact.html">Contacting the IOCCC</a>
|
||
</div>
|
||
<hr>
|
||
<div class="sidenav">
|
||
<a href="#top">Jump to top</a>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/sidenav.default.html -->
|
||
<!-- START: this line starts content from: inc/end-leftcolumn.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-leftcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/begin-rightcolumn.default.html -->
|
||
|
||
<div class="rightcolumn">
|
||
|
||
<!-- END: this line ends content from: inc/begin-rightcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/before-content.default.html -->
|
||
|
||
<a name="content"></a>
|
||
|
||
<!-- END: this line ends content from: inc/before-content.default.html -->
|
||
<!-- START: this line starts content generated by: bin/gen-author.sh -->
|
||
|
||
<p><a name="author"><strong>Author:</strong></a> <br><br>Name: <a
|
||
href="/temp-test-ioccc/winners.html#Tero_Kivinen">Tero Kivinen</a><br>
|
||
Location: <a href="/temp-test-ioccc/location.html#FI">FI</a></p>
|
||
|
||
<!-- END: next line ends content generated by: bin/gen-author.sh -->
|
||
<h2 id="to-build">To build:</h2>
|
||
<p>If your machine support the X Window System, Version 11:</p>
|
||
<div class="sourceCode" id="cb1"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> alt</span></code></pre></div>
|
||
<p>We recommend that you try the alt version first so you can get a
|
||
better idea of what this looked like back in 1992. See <a
|
||
href="#original-code">original code</a> for the original should you wish
|
||
to see what we mean.</p>
|
||
<h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
|
||
<p>The current status of this entry is:</p>
|
||
<pre><code>STATUS: known bug - please help us fix</code></pre>
|
||
<p>For more detailed information see <a
|
||
href="/bugs.md#1992-kivinen">1992 kivinen in bugs.md</a>.</p>
|
||
<h2 id="to-use">To use:</h2>
|
||
<div class="sourceCode" id="cb3"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./kivinen.alt</span></span>
|
||
<span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a></span>
|
||
<span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a><span class="ex">./kivinen.alt</span> a</span>
|
||
<span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a></span>
|
||
<span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a><span class="ex">./kivinen.alt</span> a b</span></code></pre></div>
|
||
<p>See also the author’s remarks for other variations.</p>
|
||
<h2 id="try">Try:</h2>
|
||
<p>Also try changing the speed that the game moves. For instance if you
|
||
wish to change the <code>usleep(3)</code> value to <code>30000</code>
|
||
from <code>20000</code>, try:</p>
|
||
<div class="sourceCode" id="cb4"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> clobber SLEEP=30000 alt <span class="co"># make it slower</span></span>
|
||
<span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a></span>
|
||
<span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> clobber SLEEP=10000 alt <span class="co"># make it faster</span></span></code></pre></div>
|
||
<p>Then use the same syntax as above and described by the author.</p>
|
||
<h2 id="original-code">Original code:</h2>
|
||
<p>As noted above, the alt version is recommended because the code goes
|
||
too fast in modern systems. If you wish to see the original you may do
|
||
so with the original code.</p>
|
||
<h3 id="original-build">Original build:</h3>
|
||
<div class="sourceCode" id="cb5"><pre class="sourceCode sh"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">make</span> all</span></code></pre></div>
|
||
<h3 id="original-use">Original use:</h3>
|
||
<p>Use <code>kivinen</code> as you would <code>kivinen.alt</code>.</p>
|
||
<h2 id="judges-remarks">Judges’ remarks:</h2>
|
||
<p>The type of entertainment depends on number of arguments you have
|
||
with the program. :-)</p>
|
||
<p>NOTE: Some systems do not need (or have)
|
||
<code>-lsocket -lresolv -lnsl</code>. Such systems should compile using
|
||
<code>-lX11</code>.</p>
|
||
<p>NOTE: The original winning source <a
|
||
href="kivinen.orig.c">kivinen.orig.c</a> assumed that
|
||
<code>exit(3)</code> returned a value which cause problems for some
|
||
systems where <code>exit(3)</code> returns <code>void</code>. The file
|
||
<a href="kivinen.c">kivinen.c</a> avoids this problem.</p>
|
||
<h2 id="authors-remarks">Author’s remarks:</h2>
|
||
<h3 id="x-entertainment-kit">X Entertainment Kit</h3>
|
||
<p>This kit includes three games from the early era of video games
|
||
designed for the X Window System Version 11 Release 5. It should work
|
||
with earlier releases, though.</p>
|
||
<h4 id="space-invaders">Space Invaders</h4>
|
||
<p>The classic game of shooting aliens from outer space, trying to
|
||
exterminate all life on earth. The game ends when the first line of
|
||
aliens touches the ground, or destroy you. To win the game you must
|
||
destroy all the aliens. If you evade out from the screen you lose.</p>
|
||
<h5 id="controls">Controls</h5>
|
||
<ul>
|
||
<li>Button 1 = Move left</li>
|
||
<li>Button 2 = Fire missile</li>
|
||
<li>Button 3 = Move right</li>
|
||
</ul>
|
||
<h4 id="breakout">Breakout</h4>
|
||
<p>Break all the bricks with the ball, using your paddle. If you miss
|
||
the ball the game ends.</p>
|
||
<h5 id="controls-1">Controls</h5>
|
||
<ul>
|
||
<li>Button 1 = Move left</li>
|
||
<li>Button 3 = Move right</li>
|
||
</ul>
|
||
<h4 id="dropout">Dropout</h4>
|
||
<p>Catch all the falling pieces, before they reach the ground. If you
|
||
miss it, game ends. To win you must catch all 30 pieces.</p>
|
||
<h5 id="controls-2">Controls</h5>
|
||
<ul>
|
||
<li>Button 1 = Move left</li>
|
||
<li>Button 3 = Move right</li>
|
||
</ul>
|
||
<h3 id="starting-a-game">Starting a game</h3>
|
||
<p>The type of the game is determined by the number of arguments given
|
||
to the program.</p>
|
||
<ul>
|
||
<li>no arguments = Space Invaders</li>
|
||
<li>1 argument = Breakout</li>
|
||
<li>2 arguments = Dropout</li>
|
||
<li>3 arguments = double sized Breakout</li>
|
||
<li>4 arguments = triple sized Space Invaders</li>
|
||
<li>5 arguments = triple sized Breakout</li>
|
||
<li>6 arguments = double sized Dropout</li>
|
||
<li>7 arguments = quadruple sized Breakout</li>
|
||
</ul>
|
||
<p>…and so on…</p>
|
||
<h3 id="scores">Scores</h3>
|
||
<p>The exit value of the game is your score. The smaller the score the
|
||
better it is. The exit value of zero means you have won.</p>
|
||
<h3 id="features">Features</h3>
|
||
<p>The game has a cheat system, which can be found after examining the
|
||
event loop at the end of program. It is not a bug, it’s a feature!</p>
|
||
<h2 id="copyright-and-cc-by-sa-4.0-license">Copyright and CC BY-SA 4.0
|
||
License:</h2>
|
||
<p>This file is Copyright (c) 2023 by Landon Curt Noll. All Rights
|
||
Reserved. You are free to share and adapt this file under the terms of
|
||
this license:</p>
|
||
<pre><code>Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</code></pre>
|
||
<p>For more information, see:
|
||
https://creativecommons.org/licenses/by-sa/4.0/</p>
|
||
<!-- START: this line starts content generated by: bin/gen-inventory.sh -->
|
||
|
||
<h1 id="inventory-for-1992kivinen"><a name="inventory"></a>Inventory for
|
||
1992/kivinen</h1>
|
||
<h2 id="primary-files">Primary files</h2>
|
||
<ul>
|
||
<li><a href="index.html">index.html</a> - winner home page</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/kivinen.c">kivinen.c</a>
|
||
- winning source</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/Makefile">Makefile</a>
|
||
- winner Makefile</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/kivinen.alt.c">kivinen.alt.c</a>
|
||
- alternative source</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/kivinen.orig.c">kivinen.orig.c</a>
|
||
- original source</li>
|
||
<li><a href="1992_kivinen.tar.bz2">1992_kivinen.tar.bz2</a> - download
|
||
winning source</li>
|
||
</ul>
|
||
<h2 id="secondary-files">Secondary files</h2>
|
||
<ul>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/.gitignore">.gitignore</a>
|
||
- list of files that should not be committed under git</li>
|
||
<li><a href=".path">.path</a> - directory path from top directory</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/.winner.json">.winner.json</a>
|
||
- description of winner in JSON</li>
|
||
<li><a
|
||
href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/1992/kivinen/README.md">README.md</a>
|
||
- markdown source for index.html</li>
|
||
</ul>
|
||
|
||
<!-- END: next line ends content generated by: bin/gen-inventory.sh -->
|
||
<!-- START: this line starts content from: inc/after-content.default.html -->
|
||
|
||
<!-- END: this line ends content from: inc/after-content.default.html -->
|
||
<!-- START: this line starts content from: inc/end-rightcolumn.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-rightcolumn.default.html -->
|
||
<!-- START: this line starts content from: inc/end-row.default.html -->
|
||
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/end-row.default.html -->
|
||
<!-- START: this line starts content from: inc/footer.default.html -->
|
||
|
||
<div class="footer">
|
||
<hr>
|
||
<h2>Coda</h2>
|
||
<p><a href="https://validator.w3.org/nu/?doc=https%3A%2F%2Fioccc-src.github.io%2Ftemp-test-ioccc%2F1992%2Fkivinen%2Findex.html">Nu HTML check this web page</a></p>
|
||
<p><a href="#top">Jump to top</a> <a href="#content">Jump to Content</a> <a href="#inventory">Jump to Inventory</a></p>
|
||
</div>
|
||
|
||
<!-- END: this line ends content from: inc/footer.default.html -->
|
||
<!-- START: this line starts content from: inc/bottom.default.html -->
|
||
|
||
</body>
|
||
</html>
|
||
|
||
<!-- END: this line ends content from: inc/bottom.default.html -->
|