Avoid a problem with the mutex code.

[irker.git] / irkerd.xml

diff --git a/irkerd.xml b/irkerd.xml
index c203fa8b789c2d4fa200e20ffcfd20e58aea5044..b24c39e6279772226added15e5a3d2ac5f223a3a 100644 (file)
--- a/irkerd.xml
+++ b/irkerd.xml
@@ -1,13 +1,13 @@
 <!DOCTYPE refentry PUBLIC 
    "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "docbook/docbookx.dtd">
-<refentry id='irkerd.1'>
+<refentry id='irkerd.8'>
 <refmeta>
 <refentrytitle>irkerd</refentrytitle>
-<manvolnum>1</manvolnum>
+<manvolnum>8</manvolnum>
 <refmiscinfo class='date'>Aug 27 2012</refmiscinfo>
-<refmiscinfo class='source'>irkerd</refmiscinfo>
-<refmiscinfo class='product'>irkerd</refmiscinfo>
+<refmiscinfo class='source'>irker</refmiscinfo>
+<refmiscinfo class='product'>irker</refmiscinfo>
 <refmiscinfo class='manual'>Commands</refmiscinfo>
 </refmeta>
 <refnamediv id='name'>
@@ -43,14 +43,21 @@ Examples:
 {"to":"irc://chat.hypothetical.net:6668/git-ciabot", "privmsg":"Hello, world!"}
 </programlisting></para>
 
-<para>If the channel part of the URL does not have one of the prefix characters
-<quote>#</quote>, <quote>&amp;</quote>, or <quote>+</quote>, a <quote>#</quote>
-will be prepended to it before shipping.</para>
+<para>If the channel part of the URL does not have one of the prefix
+characters <quote>#</quote>, <quote>&amp;</quote>, or
+<quote>+</quote>, a <quote>#</quote> will be prepended to it before
+shipping - <emphasis>unless</emphasis>the channel part has the suffix
+",isnick" (which is unconditionally removed).</para>
 
 <para>The host part of the URL may have a port-number suffix separated by a
 colon, as shown in the third example; otherwise
 <application>irkerd</application> sends messages to the the default 6667 IRC
 port of each server.</para>
+
+<para>An empty message is legal and will cause 
+<application>irkerd</application> to join the target channels without
+actually emitting a message.  This may be useful for advertising that
+an instance is up and running.</para>
 </refsect1>
 
 <refsect1 id='options'><title>OPTIONS</title>
@@ -102,7 +109,7 @@ discarded. </para>
 <refsect1 id='authors'><title>AUTHOR</title>
 <para>Eric S. Raymond <email>esr@snark.thyrsus.com</email>.  See the
 project page at <ulink
-url='http://www.catb.org/~esr/'>http://www.catb.org/~esr/irker</ulink>
+url='http://www.catb.org/~esr/irker'>http://www.catb.org/~esr/irker</ulink>
 for updates and other resources, including an installable repository
 hook script. The implementation uses the Python IRC library by Joe
 Rosdahl and Jason R. Coombs.</para>