X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~matthewv/git?p=irc.git;a=blobdiff_plain;f=servus.html;h=8202041a862e09d1be1c3b8d3c377b3b3cdeabfb;hp=43ed887b89a256881147bb7243bcbcdb8c413043;hb=919b84f0890c944514afc1c14c86c5eb51743792;hpb=0d052d1888a4d2a945bb06047b43f5e5c836aaee

diff --git a/servus.html b/servus.html
index 43ed887..8202041 100644
--- 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
-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
-href="http://www.chiark.greenend.org.uk/~matthewv/irc/.git">http://www.chiark.greenend.org.uk/~matthewv/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
@@ -37,6 +38,8 @@ class="code">~command</span>. Alternatively, you may pass commands by
 <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>
@@ -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="#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>
@@ -63,11 +68,32 @@ class="code">~command</span>. Alternatively, you may pass commands by
 
 <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>
-<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,
@@ -147,6 +173,14 @@ removed from channel for excess flooding).</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
@@ -222,12 +256,19 @@ 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
-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>