From db2cef1ab11cc58cc92c16fd9bccd0fe17e413e4 Mon Sep 17 00:00:00 2001 From: Wilmer van der Gaast Date: Tue, 13 Jul 2010 01:09:40 +0100 Subject: Document this complex new beast. --- doc/user-guide/commands.xml | 31 ++++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) (limited to 'doc/user-guide/commands.xml') diff --git a/doc/user-guide/commands.xml b/doc/user-guide/commands.xml index be61e4db..d0ce485e 100644 --- a/doc/user-guide/commands.xml +++ b/doc/user-guide/commands.xml @@ -763,7 +763,6 @@ - You can use this option to set your nickname in a chatroom. You won't see this nickname yourself, but other people in the room will. By default, BitlBee will use your username as the chatroom nickname. @@ -771,6 +770,36 @@ + + %-@nick + + + + By default, BitlBee tries to derive sensible nicknames for all your contacts from their IM handles. In some cases, IM modules (ICQ for example) will provide a nickname suggestion, which will then be used instead. This setting lets you change this behaviour. + + + + Whenever this setting is set for an account, it will be used for all its contacts. If it's not set, the global value will be used. + + + + It's easier to describe this setting using a few examples: + + + + FB-%full_name will make all nicknames start with "FB-", followed by the person's full name. For example you can set this format for your Facebook account so all Facebook contacts are clearly marked. + + + + [%group]%-@nick will make all nicknames start with the group the contact is in between square brackets, followed by the nickname suggestions from the IM module if available, or otherwise the handle. Because of the "-@" part, everything from the first @ will be stripped. + + + + See help nick_format for more information. + + + + handle handle, full_name, first_name -- cgit v1.2.3