From 12b29dbdce259ad7c65b4b890b5d9a1bd44b60b4 Mon Sep 17 00:00:00 2001 From: Wilmer van der Gaast Date: Sun, 13 Jun 2010 00:40:12 +0200 Subject: Small doc update on multi-channel stuff. The "channel" command is not documented yet. --- doc/user-guide/help.xml | 1 + doc/user-guide/misc.xml | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) (limited to 'doc/user-guide') diff --git a/doc/user-guide/help.xml b/doc/user-guide/help.xml index 7487a841..0684512e 100644 --- a/doc/user-guide/help.xml +++ b/doc/user-guide/help.xml @@ -13,6 +13,7 @@ These are the available help subjects: quickstartA short introduction into BitlBee commandsAll available commands and settings + channelsAbout creating and customizing channels awayAbout setting away states smileysA summary of some non-standard smileys you might find and fail to understand groupchatsHow to work with groupchats on BitlBee diff --git a/doc/user-guide/misc.xml b/doc/user-guide/misc.xml index 2427ef69..9a0bb67f 100644 --- a/doc/user-guide/misc.xml +++ b/doc/user-guide/misc.xml @@ -133,4 +133,50 @@ To restore your logged-in status, you need to either use the register< + +Dealing with channels + + +You can have as many channels in BitlBee as you want. You maintain your channel list using the channel command. You can create new channels by just joining them, like on regular IRC networks. + + + +You can create two kinds of channels. Control channels, and groupchat channels. By default, BitlBee will set up new channels as control channels if their name starts with an &, and as chat channels if it starts with a #. + + + +Control channels are where you see your contacts. By default, you will have one control channel called &bitlbee, containing all your contacts. But you can create more, if you want, and divide your contact list accross several channels. + + + +For example, you can have one channel with all contacts from your MSN Messenger account in it. Or all contacts from the group called "Work". + + + +Type help channels2 to read more. + + + + + +Creating a channel + + +When you create a new channel, BitlBee will try to guess from its name which contacts to fill it with. For example, if the channel name (excluding the &) matches the name of a group in which you have one or more contacts, the channel will contain all those contacts. + + + +Any valid account ID (so a number, protocol name or part of screenname, as long as it's unique) can also be used as a channel name. So if you just join &msn, it will contain all your MSN contacts (as long as you have only one MSN account set up). And if you have a Facebook account set up, you can see its contacts by just joining &facebook. + + + +To start a simple group chat, you simply join a channel which a name starting with #, and invite people into it. All people you invite have to be on the same IM network and contact list. + + + +If you want to configure your own channels, you can use the channel set. + + + + -- cgit v1.2.3