# HG changeset patch
# User Mikael Berthe <mikael@lilotux.net>
# Date 1188075326 -7200
# Node ID 2c96720c4f5bb91040163bc8d02e4cefc959f58d
# Parent  2faf179166f398f27375f207983e1ec74781d482
Add comments (vorner)

diff -r 2faf179166f3 -r 2c96720c4f5b mcabber/src/screen.c
--- a/mcabber/src/screen.c	Sat Aug 25 22:48:59 2007 +0200
+++ b/mcabber/src/screen.c	Sat Aug 25 22:55:26 2007 +0200
@@ -237,6 +237,7 @@
   g_free(col);
 }
 
+// Removes all roster coloring rules
 void scr_RosterClearColor(void)
 {
   GSList *head;
@@ -247,6 +248,13 @@
   rostercolrules = NULL;
 }
 
+// Adds, modifies or removes roster coloring rule
+// color set to "-" removes the rule,
+// otherwise it is modified (if exists) or added
+//
+// Returns weather it was successfull (therefore the roster should be
+// redrawed) or not. If it failed, for example because of invalid color
+// name, it also prints the error.
 bool scr_RosterColor(const char *status, const char *wildcard,
                      const char *color)
 {