# HG changeset patch
# User Michal 'vorner' Vaner <vorner@ucw.cz>
# Date 1188289591 -7200
# Node ID 359e1c53552a932c17482db179da396c6ddb1d15
# Parent  382ec54b584e2f8a4b9f8ea2822031b9fc4cd1ee
Coloring help

diff -r 382ec54b584e -r 359e1c53552a mcabber/doc/help/en/hlp_color.txt
--- a/mcabber/doc/help/en/hlp_color.txt	Tue Aug 28 10:11:39 2007 +0200
+++ b/mcabber/doc/help/en/hlp_color.txt	Tue Aug 28 10:26:31 2007 +0200
@@ -1,16 +1,32 @@
 
  /COLOR roster (status wildcard (color|-)|clear)
+ /COLOR mucnick nick (color|-)
+ /COLOR muc (jid|.|*) [on|preset|off|-]
 
 The 'color' command allows setting dynamic color properties of the screen.
 
 /color roster clear
- Remove all color rules for the roster.
- All roster items will get its default color.
+ Remove all color rules for the roster. All roster items will get its default
+ color.
 /color roster status wildcard color
- Set a color rule (or overwrite, if it already exists).
- The status is string containing all statuses the roster item can have for the
- rule to match, or * if any status is OK.
- Wildcard is the file-matching wildcard that will be applied to JID.
- Color is the wanted color.
+ Set a color rule (or overwrite, if it already exists). The status is string
+ containing all statuses the roster item can have for the rule to match,
+ or * if any status is OK. Wildcard is the file-matching wildcard that will be
+ applied to JID. Color is the wanted color.
  If color is -, the rule is removed.
- If more than one rule matches, the color from the last created (not overwritten) is used.
+ If more than one rule matches, the color from the last created
+ (not overwritten) is used.
+/color mucnick nick (color|-)
+ Marks the nick to be colored by given color. If a muc has colored nicks, this
+ one will be used. If color is -, the color is marked as chosen automatically,
+ which means it will not be used in 'preset' coloring mode, but will stay the
+ same in 'on' coloring mode.
+/color muc (jid|.|*) [on|preset|off|-]
+ Sets a muc nick coloring mode. If a jid (. means currently selected jid) is
+ provided, the mode will apply to this specific MUC. If * is used, it will be
+ applied to all MUCs, except the ones set by their jid.
+ Mode 'on' colors all nicks, 'preset' only the ones manually set by /color
+ mucnick command and 'off' colors none. If not specified, defaults to 'on'
+ Mode '-' removes the mode from given JID, which means the global one will
+ apply. You can not remove the global mode.
+ Default global coloring mode is 'off'.
diff -r 382ec54b584e -r 359e1c53552a mcabber/mcabberrc.example
--- a/mcabber/mcabberrc.example	Tue Aug 28 10:11:39 2007 +0200
+++ b/mcabber/mcabberrc.example	Tue Aug 28 10:26:31 2007 +0200
@@ -288,6 +288,14 @@
 #color roster * * white
 #color roster adn *@jabber.org yellow
 
+#You can let mcabber color nicks in MUC.
+#These colors will by used automatically:
+#set nick_colors = red green blue
+#color muc *
+#
+#If you want someone's nick to be the same all the time:
+#color mucnick my_friend yellow
+
 # Style
 # Note: the "log_win_height" and "roster_width" values below can be set
 # in real time when mcabber is running.  Refresh the screen (Ctrl-l) to