Changeset f7b44f2


Ignore:
Timestamp:
2007-06-30T21:52:44Z (17 years ago)
Author:
Wilmer van der Gaast <wilmer@…>
Branches:
master
Children:
3b6eadc, ae3c4fa
Parents:
05bcd20
Message:

Added help information for the join_chat command and its five arguments,
which were completely undocumented so far. Also removed the import_buddies
information because that command doesn't exist anymore anyway.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/user-guide/commands.xml

    r05bcd20 rf7b44f2  
    811811        </bitlbee-command>
    812812
    813         <bitlbee-command name="import_buddies">
    814                 <short-description>Copy local buddy list to server (normally only needed when upgrading)</short-description>
    815                 <syntax>import_buddies &lt;connection&gt; [clear]</syntax>
    816 
    817                 <description>
    818                         <para>
    819                                 This command copies the locally stored buddy list to the server. This command exists for upgrading purposes. Previous versions of BitlBee didn't support server-side buddy lists for ICQ, so the list was stored locally.
    820                         </para>
    821 
    822                         <para>
    823                                 Since version 0.91 however, server-side contact lists are supported for all protocols, so the local list is now ignored. When upgrading from an older BitlBee to version 0.91, you might need this command to get your buddy list back.
    824                         </para>
    825 
    826                         <para>
    827                                 The only argument this command needs is your ICQ account identification. If your serverside buddy list contains some old buddies you don't want anymore, you can pass <emphasis>clear</emphasis> as a second argument.
    828                         </para>
    829 
    830                         <para>
    831                                 After giving this command, you have to wait for a while before all the adds are handled, because of ICQ's rate limiting. If your buddy list is very large and the ICQ server starts complaining, you might have to reconnect and enter this command again.
    832                         </para>
    833                 </description>
     813        <bitlbee-command name="join_chat">
     814                <short-description>Join a named groupchat/conference room</short-description>
     815                <syntax>import_buddies &lt;connection&gt; &lt;room name&gt; [&lt;channel name&gt;] [&lt;room nickname&gt;] [&lt;password&gt;]</syntax>
     816
     817                <description>
     818                        <para>
     819                                On most IM-networks groupchats can be started using the /join command. (<emphasis>/join #foo</emphasis> to start a chatroom with you and <emphasis>foo</emphasis>) This doesn't work with names groupchats though (which exist on Jabber networks and AIM, for example), instead you can use this command.
     820                        </para>
     821
     822                        <para>
     823                                The first two arguments are required. <emphasis>room name</emphasis> is the name of the chatroom on the IM-network. <emphasis>channel name</emphasis> is the IRC channel name BitlBee should map this to. <emphasis>room nickname</emphasis> is the nickname you want to have in this channel. If you don't give these options, BitlBee will do the right guesses.
     824                        </para>
     825
     826                        <para>
     827                                The following command will join you to the chatroom called <emphasis>bitlbee@conference.bitlbee.org</emphasis>. The channel will be called <emphasis>&amp;bitlbee-help</emphasis> because <emphasis>&amp;bitlbee</emphasis> will already be in use. Your nickname will be <emphasis>help-me</emphasis>.
     828                        </para>
     829                </description>
     830
     831                <ircexample>
     832                        <ircline nick="wilmer">join_chat jabber bitlbee@conference.bitlbee.org &amp;bitlbee-help help-me</ircline>
     833                </ircexample>
    834834
    835835        </bitlbee-command>
Note: See TracChangeset for help on using the changeset viewer.