Changeset 286b28e for doc/user-guide

Timestamp:

2010-03-13T01:02:47Z (15 years ago)

Author:

Wilmer van der Gaast <wilmer@…>

Branches:

master

Children:

bb34771

Parents:

1be0d26

Message:

Added nick_source account setting to allow using full name fields for
generating nicknames instead of just the handle.

File:

• doc/user-guide/commands.xml (modified) (1 diff)

doc/user-guide/commands.xml

@@ -608 +608 @@
         </bitlbee-setting>
 
+        <bitlbee-setting name="nick_source" type="string" scope="account">
+                <default>handle</default>
+                <possible-values>handle, full_name, first_name</possible-values>
+
+                <description>
+                        <para>
+                                By default, BitlBee generates a nickname for every contact by taking its handle and chopping off everything after the @. In some cases, this gives very inconvenient nicknames. The Facebook XMPP server is a good example, as all Facebook XMPP handles are numeric.
+                        </para>
+
+                        <para>
+                                With this setting set to <emphasis>full_name</emphasis>, the person's full name is used to generate a nickname. Or if you don't like long nicknames, set this setting to <emphasis>first_name</emphasis> instead and only the first word will be used. Note that the full name can be full of non-ASCII characters which will be stripped off.
+                        </para>
+                </description>
+        </bitlbee-setting>
+
         <bitlbee-setting name="ops" type="string" scope="global">
                 <default>both</default>