Update rhawk page

[pages] / tools / rhawk.md

diff --git a/tools/rhawk.md b/tools/rhawk.md
index 039d63e5da35d83ad3fe6cae8838e3b755d13c75..7fac8a8ca31e32ce272df9187f9c9fd1a964f2f6 100644 (file)
--- a/tools/rhawk.md
+++ b/tools/rhawk.md
@@ -1 +1,47 @@
-rhawk is a IRC bot written in.. well.. awk.
+rhawk is a IRC bot written in GNU Awk.
+
+Source Code
+-----------
+Source code is available in git and [gitweb](/git/?p=~andy/rhawk)
+
+    git clone git://pileus.org/~andy/rhawk
+
+Components
+----------
+<dl>
+  <dt>rhawk</dt>
+  <dd>rhawk is the main awk script that starts up the IRC bot. It requires a
+      network connection as standard input and output. The suggested way to do
+      this is by using socat as shown in rhawk.sh</dd>
+
+  <dt>irc.awk</dt>
+  <dd><p>IRC protocol handling is done in the irc awk script. In addition to
+         the pure protocol things, irc.awk also provides some framework code to
+         handle starting, stopping, and reloading the client.</p>
+
+      <p>When included, the irc script will spawn a child instance of rhawk.
+         This is done so that the client can be reloaded without dropping the
+         existing IRC connection.</p></dd>
+
+  <dt>json.awk</dt>
+  <dd>A simple json parser is included, it has no external dependencies, so it
+      can be used by other awk scripts as well.</dd>
+
+  <dt>email.awk</dt>
+  <dd>The email component provides notifications to IRC users if someone says
+      their name while they are away.</dd>
+
+  <dt>spades.awk</dt>
+  <dd>Spades is a great card game. As such, rhawk lets you play spades by
+      joining the #rhspades channel on freenode.net and issuing the .newgame
+      command. Note, you'll have to get three other players as well.
+      The '.help spades' command provides a list of spades commands.</dd>
+</dl>
+
+rhsed
+-----
+Awk is a great language for writing an IRC bot.
+
+Sed, on the other hand, is not so a great at it.
+
+* [gitweb](/git/?p=~andy/rhawk;f=rhsed;a=blob)