added online help
[rfk] / help.html
diff --git a/help.html b/help.html
new file mode 100644 (file)
index 0000000..530a85b
--- /dev/null
+++ b/help.html
@@ -0,0 +1,99 @@
+<html>
+<head><title>robotfindskitten</title></head>
+<style type="text/css">
+body {
+       color: green;
+       background-color: black;
+       text-align: center;
+       font-size: 20pt;
+       font-family: serif;
+}
+h1 {
+       font-size: 40pt;
+}
+a {
+       color: yellow;
+}
+</style>
+<body>
+<h1>robotfindskitten</h1>
+
+<p>robotfindskitten is a Zen simulation.  robot must find kitten
+in an area full of non-kitten items.  The original version was
+written in 1997 by the illustrious Leonard Richardson for the Nerth
+Pork robotfindskitten contest.  This Maemo port was written by
+Thomas Thurman in 2009.</p>
+
+<p>You may learn more at <a href="http://www.robotfindskitten.org">the
+robotfindskitten website</a>.</p>
+
+<p>You may scroll this help text.  When you
+are done, you may close this window and return
+to robotfindskitten</a>.</p>
+
+<h2>Moving robot around</h2>
+
+<p>There are three ways to move robot around.  Firstly, you may tap
+on any side of robot to move robot in that direction, including
+diagonally.</p>
+
+<p>Secondly, you may use the arrow keys on the keyboard.  However,
+this does not allow you to move diagonally.</p>
+
+<p>Thirdly, you may use the vi keys (also called the nethack keys).
+They are:</p>
+<center>
+<big><big><pre>
+y  k  u
+h  &middot;  l
+b  j  n
+</pre></big></big>
+</center>
+</p>
+
+<h2>Run, robot, run!</h2>
+<p>If you are controlling robot with the keyboard, then holding
+down Shift as you move will make robot run until meeting
+an item or the wall.</p>
+
+<h2>Adding new non-kitten items</h2>
+<p>There is no way to do this.  It should be in the next release.</p>
+
+<h2>Background</h2>
+<p>&quot;Day and night I feverishly worked upon the
+machine, creating both a soul which could desire
+its goal, and a body with which it could realize
+it. Many who saw my creation called it an
+abomination, and denied me grant money. But they
+could not dissuade me from my impossible task. It
+was a spectre that tormented me always, a ghost I
+had to give a form and a life, lest it consume me
+from the inside.  And when at last my task was
+done, when the grey box on wheels was complete and
+when it, as well as I, knew what had to be done, I
+felt deep sympathy for the machine.  For I had not
+destroyed the phantom, but merely exorcized it
+into another body. The robot knew not why this
+task had to be performed, for I could not imbue it
+with knowledge I did not myself posess. And at the
+same time, I felt a sweeping sense of relief sweep
+over me, that somehow, the dream that had driven
+me for my entire life had come one step closer to
+fruition.  &quot;As I vocally activated the robot, I
+realized that it was following my instructions,
+but not out of any desire to obey me. Had I
+remained silent, it would have performed
+exactly the same operations. We were two beings
+controlled by the same force now. And yet, seeking
+vainly to hold some illusion of control over the
+machine I thought I had created, I gave my final
+command.</p>
+
+<p>&quot;`GO!' I told the box as it began to roll out of
+my workshop into the frozen desert beyond. `FIND
+KITTEN!'&quot;</p>
+
+<p><cite>&mdash; The Book of Found Kittens</cite>, pages 43-4, author unknown</p>
+
+</body>
+</html>