source: doc/user-guide/misc.xml @ f9110b4

<chapter id="misc">
<title>Misc Stuff</title>

<sect1 id="smileys">
<title>Smileys</title>

<para>
All MSN smileys (except one) are case insensitive and work without the nose too.
</para>

<variablelist>
        <varlistentry><term>(Y)</term><listitem><para>Thumbs up</para></listitem></varlistentry>
        <varlistentry><term>(N)</term><listitem><para>Thumbs down</para></listitem></varlistentry>
        <varlistentry><term>(B)</term><listitem><para>Beer mug</para></listitem></varlistentry>
        <varlistentry><term>(D)</term><listitem><para>Martini glass</para></listitem></varlistentry>
        <varlistentry><term>(X)</term><listitem><para>Girl</para></listitem></varlistentry>
        <varlistentry><term>(Z)</term><listitem><para>Boy</para></listitem></varlistentry>
        <varlistentry><term>(6)</term><listitem><para>Devil smiley</para></listitem></varlistentry>
        <varlistentry><term>:-[</term><listitem><para>Vampire bat</para></listitem></varlistentry>
        <varlistentry><term>(})</term><listitem><para>Right hug</para></listitem></varlistentry>
        <varlistentry><term>({)</term><listitem><para>Left hug</para></listitem></varlistentry>
        <varlistentry><term>(M)</term><listitem><para>MSN Messenger or Windows Messenger icon (think a BitlBee logo here ;)</para></listitem></varlistentry>
        <varlistentry><term>:-S</term><listitem><para>Crooked smiley (Confused smiley)</para></listitem></varlistentry>
        <varlistentry><term>:-$</term><listitem><para>Embarrassed smiley</para></listitem></varlistentry>
        <varlistentry><term>(H)</term><listitem><para>Smiley with sunglasses</para></listitem></varlistentry>
        <varlistentry><term>:-@</term><listitem><para>Angry smiley</para></listitem></varlistentry>
        <varlistentry><term>(A)</term><listitem><para>Angel smiley</para></listitem></varlistentry>
        <varlistentry><term>(L)</term><listitem><para>Red heart (Love)</para></listitem></varlistentry>
        <varlistentry><term>(U)</term><listitem><para>Broken heart</para></listitem></varlistentry>
        <varlistentry><term>(K)</term><listitem><para>Red lips (Kiss)</para></listitem></varlistentry>
        <varlistentry><term>(G)</term><listitem><para>Gift with bow</para></listitem></varlistentry>
        <varlistentry><term>(F)</term><listitem><para>Red rose</para></listitem></varlistentry>
        <varlistentry><term>(W)</term><listitem><para>Wilted rose</para></listitem></varlistentry>
        <varlistentry><term>(P)</term><listitem><para>Camera</para></listitem></varlistentry>
        <varlistentry><term>(~)</term><listitem><para>Film strip</para></listitem></varlistentry>
        <varlistentry><term>(T)</term><listitem><para>Telephone receiver</para></listitem></varlistentry>
        <varlistentry><term>(@)</term><listitem><para>Cat face</para></listitem></varlistentry>
        <varlistentry><term>(&amp;)</term><listitem><para>Dog's head</para></listitem></varlistentry>
        <varlistentry><term>(C)</term><listitem><para>Coffee cup</para></listitem></varlistentry>
        <varlistentry><term>(I)</term><listitem><para>Light bulb</para></listitem></varlistentry>
        <varlistentry><term>(S)</term><listitem><para>Half-moon (Case sensitive!)</para></listitem></varlistentry>
        <varlistentry><term>(*)</term><listitem><para>Star</para></listitem></varlistentry>
        <varlistentry><term>(8)</term><listitem><para>Musical eighth note</para></listitem></varlistentry>
        <varlistentry><term>(E)</term><listitem><para>Envelope</para></listitem></varlistentry>
        <varlistentry><term>(^)</term><listitem><para>Birthday cake</para></listitem></varlistentry>
        <varlistentry><term>(O)</term><listitem><para>Clock</para></listitem></varlistentry>
</variablelist>

</sect1>

<sect1 id="groupchats">
<title>Groupchats</title>
<para>
BitlBee now supports groupchats on all IM networks. This text will try to explain you how they work.
</para>

<para>
As soon as someone invites you into a groupchat, you will be force-joined or invited (depending on the protocol) into a new virtual channel with all the people in there. You can leave the channel at any time, just like you would close the window in regular IM clients. Please note that root-commands don't work in groupchat channels, they only work in the control channel (or to root directly).
</para>

<para>
Of course you can also create your own groupchats. Type <emphasis>help groupchats2</emphasis> to see how.
</para>

</sect1>

<sect1 id="groupchats2">
<title>Creating groupchats</title>

<para>
To open a groupchat, use the <emphasis>chat with</emphasis> command. For example,  to start a groupchat with the person <emphasis>lisa_msn</emphasis> in it, just type <emphasis>chat with lisa_msn</emphasis>. BitlBee will create a new virtual channel with root, you and lisa_msn in it.
</para>

<para>
Then, just use the ordinary IRC <emphasis>/invite</emphasis> command to invite more people. Please do keep in mind that all the people have to be on the same network and contact list! You can't invite Yahoo! buddies into an MSN groupchat.
</para>

<para>
Some protocols (like Jabber) also support named groupchats. BitlBee now supports these too. You can use the <emphasis>chat add</emphasis> command to join them. See <emphasis>help chat add</emphasis> for more information.
</para>

</sect1>

<sect1 id="away">
<title>Away states</title>

<para>
To mark yourself as away, you can just use the <emphasis>/away</emphasis> command in your IRC client. BitlBee supports most away-states supported by the protocols.
</para>

<para>
Away states have different names accross different protocols. BitlBee will try to pick the best available option for every connection:
</para>

<simplelist>
        <member>Away</member>
        <member>NA</member>
        <member>Busy, DND</member>
        <member>BRB</member>
        <member>Phone</member>
        <member>Lunch, Food</member>
        <member>Invisible, Hidden</member>
</simplelist>

<para>
So <emphasis>/away Food</emphasis> will set your state to "Out to lunch" on your MSN connection, and for most other connections the default, "Away" will be chosen.
</para>

<para>
You can also add more information to your away message. Setting it to "Busy - Fixing BitlBee bugs" will set your IM-away-states to Busy, but your away message will be more descriptive for people on IRC. Most IM-protocols can also show this additional information to your buddies.
</para>

<para>
If you want to set an away state for only one of your connections, you can use the per-account <emphasis>away</emphasis> setting. See <emphasis>help set away</emphasis>.
</para>

</sect1>

</chapter>