Index: modules/filter/filter.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/filter/filter.module,v
retrieving revision 1.204.2.8
diff -u -r1.204.2.8 filter.module
--- modules/filter/filter.module	10 Dec 2008 22:30:14 -0000	1.204.2.8
+++ modules/filter/filter.module	18 Jun 2009 14:02:58 -0000
@@ -601,13 +601,18 @@
  */
 
 /**
- * Implementation of hook_filter(). Contains a basic set of essential filters.
+ * Implementation of hook_filter(). 
+ * 
+ * Sets up a basic set of essential filters:
  * - HTML filter:
- *     Validates user-supplied HTML, transforming it as necessary.
+ *     Restricts user-supplied HTML to certain tags, and removes dangerous
+ *     components in allowed tags.
  * - Line break converter:
  *     Converts newlines into paragraph and break tags.
- * - URL and e-mail address filter:
- *     Converts newlines into paragraph and break tags.
+ * - URL filter:
+ *     Converts URLs and e-mail addresses into links.
+ * - HTML corrector:
+ *     Fixes faulty HTML.
  */
 function filter_filter($op, $delta = 0, $format = -1, $text = '') {
   switch ($op) {