From 996a827a5231464eb4d31d78b56ed4054ab0f4a8 Mon Sep 17 00:00:00 2001 From: Florent Le Coz Date: Tue, 15 Apr 2014 05:42:12 +0200 Subject: Document the new dummy channel, and how biboumi creates and closes connections --- doc/biboumi.1.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/biboumi.1.md b/doc/biboumi.1.md index bd6463d..c985de7 100644 --- a/doc/biboumi.1.md +++ b/doc/biboumi.1.md @@ -111,6 +111,21 @@ If compiled with Libidn, an IRC user has a bare JID representing the To join an IRC channel `#foo` on the IRC server `irc.example.com`, join the XMPP MUC `#foo%irc.example.com@hostname`. +### Connect to an IRC server + +The connection to the IRC server is automatically made when the user tries +to join any channel on that IRC server. The connection is closed whenever +the last channel on that server is left by the user. To be able to stay +connected to an IRC server without having to be in a real IRC channel, +biboumi provides a virtual channel on the jid +`%irc_serve@biboumi.example.com`. For example if you want to join the +channel `#foo` on the server `irc.example.com`, but you need to authenticate +to a bot of the server before you can join it, you can first join the room +`%irc.example.com@biboumi.example.net` (this will effectively connect you to +the IRC server without joining any room), then send your authentication +message to the user `bot%irc.example.com@biboumi.example.net" and finally +join the room `#foo%irc.example.com@biboumi.example.net`. + ### Channel messages On XMPP, unlike on IRC, the displayed order of the messages is the same for -- cgit v1.2.3