Index: modules/filter/filter.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/filter/filter.module,v
retrieving revision 1.298
diff -u -r1.298 filter.module
--- modules/filter/filter.module	16 Oct 2009 19:06:23 -0000	1.298
+++ modules/filter/filter.module	22 Oct 2009 15:46:30 -0000
@@ -615,17 +615,21 @@
 }
 
 /**
- * Generate a selector for choosing a format in a form.
+ * Generates a selector for choosing a format in a form.
  *
- * @ingroup forms
  * @param $selected_format
- *   The ID of the format that is currently selected.
+ *   The ID of the format that is currently selected; uses the default format
+ *   for the current user if not provided.
  * @param $weight
- *   The weight of the text format.
+ *   The weight of the form element within the form.
  * @param $parents
- *   Required when defining multiple text formats on a single node or having a different parent than 'format'.
+ *   The parents array of the element. Required when defining multiple text
+ *   formats on a single form or having a different parent than 'format'.
+ *
  * @return
- *   HTML for the form element.
+ *   Form API array for the form element.
+ *
+ * @ingroup forms
  */
 function filter_form($selected_format = NULL, $weight = NULL, $parents = array('format')) {
   global $user;