X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~matthewv/git?a=blobdiff_plain;f=servus.html;h=4c37a102d0bef773bacbb94e6b94046b0001b201;hb=c1dc4786627942a6a5582fa990683d4a3142e84f;hp=812f666123225fdf3b617cb1eeaba1e58b52680f;hpb=a1ffff537922871802c062db99c9c76cca2421ff;p=irc.git diff --git a/servus.html b/servus.html index 812f666..4c37a10 100644 --- a/servus.html +++ b/servus.html @@ -1,7 +1,7 @@ + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> @@ -23,8 +23,9 @@ span.code {font-family: courier, monospace}

Introduction

Servus is one of the IRC bots on #chiark. This page documents the available -commands. A tarball of the source code is available, here, though may be a little out of date.

+commands. You can get a copy of the source code by running git-clone http://www.pick.ucam.org/~matthew/irc/.git

Invocation

Servus may be invoked in-channel using either ~command. Alternatively, you may pass commands by

Commands

+

define

+

This command returns (either on-channel or by /msg) a definition of the argument(s) of the +"define" command. This is done by using a "define:" query on +google, so the results may be a little unusual at times...

+

die

This command must be invoked by /msg only, and is only effective if invoked by the bot's owner. The bot @@ -83,7 +92,7 @@ class="code">slash).

The syntax is:
flirt target
Servus picks a flirt at random from the flirts list (/home/matthew/programming/irc/flirts on rapun), +class="code">/home/matthew/programming/irc/bot/flirts on rapun), and substitutes "target" for "%s" in the flirt line. If this command is invoked by /msg, there is a 10% chance of Servus stating who invoked it by adding "(but nick is their secret @@ -170,8 +179,8 @@ in output to the channel of the form:

The syntax is:
slash target1 / target2
Servus picks a slash at random from the slashes list (/home/matthew/programming/irc/slashes on rapun), -and substitutes "target1" for the first "%s" and "target2 for the +class="code">/home/matthew/programming/irc/bot/slashes on rapun), +and substitutes "target1" for the first "%s" and "target2" for the second "%s" in the slash line. If this command is invoked by /msg, there is a 10% chance of Servus stating who invoked it by adding "(while nick watches)" to @@ -183,7 +192,7 @@ href="slashes">http://www.pick.ucam.org/~matthew/irc/slashes.

The syntax is:
trout target
Servus picks a trout at random from the trouts list (/home/matthew/programming/irc/trouts on rapun), +class="code">/home/matthew/programming/irc/bot/trouts on rapun), and substitutes "target" for "%s" in the trout line. If this command is invoked by /msg, there is a 10% chance of Servus stating who invoked it by adding "(at the instigation of @@ -201,6 +210,18 @@ The first two will give the first value in terms of the second unit; the latter two forms convert the first value into SI units. This command is implemented by calling units(1).

+

url

+

Servus now tracks URLs pasted into #chiark, and will comment if you post a duplicate +URL. The url command provides a way for you +to check if a URL has been posted before (if not, Servus posts it on +your behalf). The syntax is:
+/msg Servus url http://some.url
+Servus will either paste the URL into channel, or /msg you to tell you it was a duplicate. Although +you can use this command in-channel (and get a response by /msg ), this is discouraged.

+
Matthew Vernon