Changeset 3320d6d for doc

Timestamp:

2016-03-20T03:58:05Z (8 years ago)

Author:

dequis <dx@…>

Branches:

master

Children:

4e0e590

Parents:

63825d6

git-author:

dequis <dx@…> (10-03-16 05:20:31)

git-committer:

dequis <dx@…> (20-03-16 03:58:05)

Message:

jabber: Add "always_use_nicks" setting, for non-anonymous MUCs

Basically the same thing as github PR #55, which fixes trac bug 415,
but this one conditionalized that behavior and uses the API introduced a
few commits ago.

I didn't think too much about the setting name and i'm open to changing
it to anything else

File:

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

doc/user-guide/commands.xml

@@ -649 +649 @@
         </bitlbee-setting>
 
+        <bitlbee-setting name="always_use_nicks" type="boolean" scope="channel">
+                <default>false</default>
+
+                <description>
+                        <para>
+                                Jabber groupchat specific. This setting ensures that the nicks defined by the other members of a groupchat are used, instead of the username part of their JID. This only applies to groupchats where their real JID is known (either "non-anonymous" ones, or "semi-anonymous" from the point of view of the channel moderators)
+                        </para>
+
+                        <para>
+                                Enabling this may have the side effect of changing the nick of existing contacts, either in your buddy list or in other groupchats. If a contact is in multiple groupchats with different nicks, enabling this setting for all those would result in multiple nick changes when joining, and the order of those changes may vary.
+                        </para>
+
+                        <para>
+                                Note that manual nick changes done through the <emphasis>rename</emphasis> command always take priority
+                        </para>
+                </description>
+        </bitlbee-setting>
+
         <bitlbee-setting name="auto_connect" type="boolean" scope="account,global">
                 <default>true</default>