X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~matthewv/git?p=irc.git;a=blobdiff_plain;f=servus.html;h=efd8fa305cc8c5f4b2aea0b94a9dd5f8dafe8fe0;hp=4c37a102d0bef773bacbb94e6b94046b0001b201;hb=d0a4a3451015ea7397f6778d5f80d0abd432a6cf;hpb=f51b635da737e39a03b9195c0ec9e58357322516 diff --git a/servus.html b/servus.html index 4c37a10..efd8fa3 100644 --- a/servus.html +++ b/servus.html @@ -23,9 +23,10 @@ span.code {font-family: courier, monospace}

Introduction

Servus is one of the IRC bots on #chiark. This page documents the available -commands. You can get a copy of the source code by running You can get a copy of the source code by running git-clone http://www.pick.ucam.org/~matthew/irc/.git

+href="http://www.chiark.greenend.org.uk/~matthewv/irc/.git">http://www.chiark.greenend.org.uk/~matthewv/irc/.git, +or via gitweb at http://www.chiark.greenend.org.uk/ucgi/~matthewv/git/irc.git/.

Invocation

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

Commands

+

blame

+

The syntax is:
+blame text
or:
+blame #trouts text
or:
+blame #flirts text
or:
+blame #slashes text
or:
+blame #last
+The first form will search for text in the + trouts, flirts, and slashes lists, and return information on + when the relevant item was added, and by whom. The next three + forms restrict the search to the specified list. The last form + is a special case that searches for the last trout, flirt, or + slash that Servus emitted.

+ +

currency

+

The syntax is:
+currency curr1 as curr2
+This will give the first currency in terms of the second + currency. Currencies must be specified using their standard currency + code. The currency conversion is performed using xe.com's + currency converter.

+

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...

+

This command no longer works, as google have broken 'define'-style + searches; it will return an error message if invoked.

die

This command must be invoked by /msg only, @@ -92,14 +119,14 @@ class="code">slash).

The syntax is:
flirt target
Servus picks a flirt at random from the flirts list (/home/matthew/programming/irc/bot/flirts on rapun), +class="code">/u2/matthewv/programming/irc/flirts on chiark), 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 admirer)" to the end of the flirt. Further suggestions for flirts should be submitted by email; a list of current flirts may be found online at http://www.pick.ucam.org/~matthew/irc/flirts.

+href="flirts">http://www.chiark.greenend.org.uk/~matthewv/irc/flirts.

google

This command returns (either on-channel or by class="code">/msg) a list of the commands Servus understands

+

nsfw

+

This command is the same as url, only you should +use it for URLs that are not work-safe. Servus will replace the "http" +in your URL with "nsfw", before passing it to url.

+ +

nws

+

This is an alias for nsfw.

+

quiet

This command prevents the use of trout, flirt, and

The syntax is:
slash target1 / target2
Servus picks a slash at random from the slashes list (/home/matthew/programming/irc/bot/slashes on rapun), +class="code">/u2/matthewv/programming/irc/slashes on chiark), 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 the end of the slash. Further suggestions for slashes should be submitted by email; a list of current slashes may be found online at http://www.pick.ucam.org/~matthew/irc/slashes.

+href="slashes">http://www.chiark.greenend.org.uk/~matthewv/irc/slashes.

trout

The syntax is:
trout target
Servus picks a trout at random from the trouts list (/home/matthew/programming/irc/bot/trouts on rapun), +class="code">/u2/matthewv/programming/irc/trouts on chiark), 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 nick)" to the end of the trout. Further suggestions for trouts should be submitted by email; a list of current trouts may be found online at -http://www.pick.ucam.org/~matthew/irc/trouts.

+http://www.chiark.greenend.org.uk/~matthewv/irc/trouts.

+ +

twit

+

The syntax is:
twit twitter-url
Servus returns (either on-channel or by /msg) the content +of the tweet and the twitter user who posted it.

units

The syntax is:
units(1).

class="code">#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.

+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; in the latter case, the URL will be sent to #urls. Although you can use this command +in-channel (and get a response by /msg ), +this is discouraged. Servus also understands nsfw:// and nsfws:// +URLs, and knows they are an obfuscation of the relevant http:// or https:// URL +for URLs that are not work-safe. You can make your firefox understand +nsfw:// URLS by visiting http://www.chiark.greenend.org.uk/~owend/free/nsfw/.

- Matthew Vernon
+ Matthew Vernon
Cambridge, England