Index: contributions/docs/developer/hooks/core.php
===================================================================
RCS file: /cvs/drupal-contrib/contributions/docs/developer/hooks/core.php,v
retrieving revision 1.168
diff -u -p -r1.168 core.php
--- contributions/docs/developer/hooks/core.php	13 Feb 2008 14:08:37 -0000	1.168
+++ contributions/docs/developer/hooks/core.php	14 Mar 2008 00:59:34 -0000
@@ -1798,6 +1798,20 @@ function custom_url_rewrite_inbound(&$re
   }
 }
 
+/**
+ * Perform alterations to messages before they are retrieved with drupal_get_messages().
+ *
+ * @param $messages
+ *   The messages set with drupal_set_message(). 
+ *   An array where the first key is the type of message (error, warning or status)
+ *   and the second key is the message_id of the message.
+ */
+function hook_message_alter(&$messages) {
+  // remove a certain message if it appears on the front page
+  if (isset($messages['status']['unwanted_message']) && drupal_is_front_page()) {
+    unset($messages['status']['unwanted_message']);
+  }
+}
 
 /**
  * @} End of "addtogroup hooks".