chiark / gitweb /
~matthewv / irc.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
new trout from rjk (ref Stross)
[irc.git] / servus.html
diff --git a/servus.html b/servus.html
index 4c37a102d0bef773bacbb94e6b94046b0001b201..45fa0bf9560fa6daa2d07073fb4cf9e347309eaf 100644 (file)
--- a/servus.html
+++ b/servus.html
@@ -23,9 +23,10 @@ span.code {font-family: courier, monospace}
 <h2>Introduction</h2>
 <p>Servus is one of the IRC bots on <span
 class="code">#chiark</span>. This page documents the available
 <h2>Introduction</h2>
 <p>Servus is one of the IRC bots on <span
 class="code">#chiark</span>. This page documents the available
-commands. You can get a copy of the source code by running <span
+commands.<br /> You can get a copy of the source code by running <span
 class="code">git-clone <a
 class="code">git-clone <a
-href="http://www.pick.ucam.org/~matthew/irc/.git">http://www.pick.ucam.org/~matthew/irc/.git</a></span></p>
+href="http://www.chiark.greenend.org.uk/~matthewv/irc/.git">http://www.chiark.greenend.org.uk/~matthewv/irc/.git</a></span>,
+or via <span class="code">gitweb</span> at <a href="http://www.chiark.greenend.org.uk/ucgi/~matthewv/git/irc.git/">http://www.chiark.greenend.org.uk/ucgi/~matthewv/git/irc.git/</a>.</p>
 
 <h2>Invocation</h2>
 <p>Servus may be invoked in-channel using either <span
 
 <h2>Invocation</h2>
 <p>Servus may be invoked in-channel using either <span
@@ -37,6 +38,8 @@ class="code">~command</span>. Alternatively, you may pass commands by
 <h2>Commands</h2>
 
 <ul>
 <h2>Commands</h2>
 
 <ul>
+<li><a href="#blame">blame</a></li>
+<li><a href="#currency">currency</a></li>
 <li><a href="#define">define</a></li>
 <li><a href="#die">die</a></li>
 <li><a href="#do">do</a></li>
 <li><a href="#define">define</a></li>
 <li><a href="#die">die</a></li>
 <li><a href="#do">do</a></li>
@@ -49,6 +52,8 @@ class="code">~command</span>. Alternatively, you may pass commands by
 <li><a href="#karmadel">karmadel</a></li>
 <li><a href="#karmalist">karmalist</a></li>
 <li><a href="#list">list</a></li>
 <li><a href="#karmadel">karmadel</a></li>
 <li><a href="#karmalist">karmalist</a></li>
 <li><a href="#list">list</a></li>
+<li><a href="#nsfw">nsfw</a></li>
+<li><a href="nws">nws</a></li>
 <li><a href="#quiet">quiet</a></li>
 <li><a href="#quit">quit</a></li>
 <li><a href="#reload">reload</a></li>
 <li><a href="#quiet">quiet</a></li>
 <li><a href="#quit">quit</a></li>
 <li><a href="#reload">reload</a></li>
@@ -56,17 +61,39 @@ class="code">~command</span>. Alternatively, you may pass commands by
 <li><a href="#say">say</a></li>
 <li><a href="#slash">slash</a></li>
 <li><a href="#trout">trout</a></li>
 <li><a href="#say">say</a></li>
 <li><a href="#slash">slash</a></li>
 <li><a href="#trout">trout</a></li>
+<li><a href="#twit">twit</a></li>
 <li><a href="#units">units</a></li>
 <li><a href="#url">url</a></li>
 </ul>
 
 <hr />
 
 <li><a href="#units">units</a></li>
 <li><a href="#url">url</a></li>
 </ul>
 
 <hr />
 
+<h3><a name="blame">blame</a></h3>
+<p>The syntax is:<br />
+<span class="code">blame text</span><br />or:<br />
+<span class="code">blame #trouts text</span><br />or:<br />
+<span class="code">blame #flirts text</span><br />or:<br />
+<span class="code">blame #slashes text</span><br />or:<br />
+<span class="code">blame #last</span><br />
+The first form will search for <span class="code">text</span> 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.</p>
+
+<h3><a name="currency">currency</a></h3>
+<p>The syntax is:<br />
+<span class="code">currency curr1 as curr2</span><br />
+This will give the first currency in terms of the second
+      currency. Currencies must be specified using their standard <a
+       href="http://en.wikipedia.org/wiki/ISO_4217">currency
+       code</a>. The currency conversion is performed using xe.com's
+      currency converter.</p>
+
 <h3><a name="define">define</a></h3>
 <h3><a name="define">define</a></h3>
-<p>This command returns (either on-channel or by <span
-class="code">/msg</span>) 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...</p>
+<p>This command no longer works, as google have broken 'define'-style
+      searches; it will return an error message if invoked.</p> 
 
 <h3><a name="die">die</a></h3>
 <p>This command must be invoked by <span class="code">/msg</span> only,
 
 <h3><a name="die">die</a></h3>
 <p>This command must be invoked by <span class="code">/msg</span> only,
@@ -99,7 +126,7 @@ 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 <a
 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 <a
-href="flirts">http://www.pick.ucam.org/~matthew/irc/flirts</a>.</p>
+href="flirts">http://www.chiark.greenend.org.uk/~matthewv/irc/flirts</a>.</p>
 
 <h3><a name="google">google</a></h3>
 <p>This command returns (either on-channel or by <span
 
 <h3><a name="google">google</a></h3>
 <p>This command returns (either on-channel or by <span
@@ -146,6 +173,14 @@ removed from channel for excess flooding).</p>
 class="code">/msg</span>) a list of the commands Servus
 understands</p> 
 
 class="code">/msg</span>) a list of the commands Servus
 understands</p> 
 
+<h3><a name="nsfw">nsfw</a></h3>
+<p>This command is the same as <a href="#url">url</a>, 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 <a href="#url">url</a>.</p>
+
+<h3><a name="nws">nws</a></h3>
+<p>This is an alias for <a href="nsfw">nsfw</a>.</p>
+
 <h3><a name="quiet">quiet</a></h3>
 <p>This command prevents the use of <span
 class="code">trout</span>, <span class="code">flirt</span>, and <span
 <h3><a name="quiet">quiet</a></h3>
 <p>This command prevents the use of <span
 class="code">trout</span>, <span class="code">flirt</span>, and <span
@@ -186,7 +221,7 @@ is invoked by <span class="code">/msg</span>, 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 <a
 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 <a
-href="slashes">http://www.pick.ucam.org/~matthew/irc/slashes</a>.</p>
+href="slashes">http://www.chiark.greenend.org.uk/~matthewv/irc/slashes</a>.</p>
 
 <h3><a name="trout">trout</a></h3>
 <p>The syntax is:<br /> <span
 
 <h3><a name="trout">trout</a></h3>
 <p>The syntax is:<br /> <span
@@ -198,7 +233,13 @@ is invoked by <span class="code">/msg</span>, 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
 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
-<a href="trouts">http://www.pick.ucam.org/~matthew/irc/trouts</a>.</p>
+<a href="trouts">http://www.chiark.greenend.org.uk/~matthewv/irc/trouts</a>.</p>
+
+<h3><a name="twit">twit</a></h3>
+<p>The syntax is:<br /><span
+class="code">twit twitter-url</span><br /> Servus returns (either on-channel or by <span
+class="code">/msg</span>) the content
+of the tweet and the twitter user who posted it.</p>
 
 <h3><a name="units">units</a></h3>
 <p>The syntax is:<br /> <span
 
 <h3><a name="units">units</a></h3>
 <p>The syntax is:<br /> <span
@@ -215,16 +256,23 @@ command is implemented by calling <span class="code">units(1)</span>.</p>
 class="code">#chiark</span>, and will comment if you post a duplicate
 URL. The <span class="code">url</span> command provides a way for you
 to check if a URL has been posted before (if not, Servus posts it on
 class="code">#chiark</span>, and will comment if you post a duplicate
 URL. The <span class="code">url</span> 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:<br /> 
-<span class="code">/msg Servus url http://some.url</span><br />
-Servus will either paste the URL into channel, or <span
-class="code">/msg</span> you to tell you it was a duplicate. Although
-you can use this command in-channel (and get a response by <span
-class="code">/msg </span>), this is discouraged.</p>
+your behalf). The syntax is:<br /> <span class="code">/msg Servus url
+http://some.url</span><br /> Servus will either paste the URL into
+channel, or <span class="code">/msg</span> you to tell you it was a
+duplicate; in the latter case, the URL will be sent to <span
+class="code">#urls</span>. Although you can use this command
+in-channel (and get a response by <span class="code">/msg </span>),
+this is discouraged. Servus also understands <span
+class="code">nsfw://</span> and <span class="code">nsfws://</span>
+URLs, and knows they are an obfuscation of the relevant <span
+class="code">http://</span> or <span class="code">https://</span> URL
+for URLs that are not work-safe. You can make your firefox understand
+<span class="code">nsfw://</span> URLS by visiting <a
+href="http://www.chiark.greenend.org.uk/~owend/free/nsfw/">http://www.chiark.greenend.org.uk/~owend/free/nsfw/</a>.</p>
 
 <hr />
 <address>
 
 <hr />
 <address>
-  <a href="mailto:matthew@sel.cam.ac.uk">Matthew Vernon</a><br />
+  <a href="mailto:matthewv@chiark.greenend.org.uk">Matthew Vernon</a><br />
   Cambridge, England
 </address>
  <p>
   Cambridge, England
 </address>
  <p>
Servus: an IRC bot