Index: includes/form.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/form.inc,v
retrieving revision 1.258
diff -u -p -r1.258 form.inc
--- includes/form.inc	2 Jan 2008 15:18:15 -0000	1.258
+++ includes/form.inc	11 Jan 2008 02:52:38 -0000
@@ -2,7 +2,26 @@
 // $Id: form.inc,v 1.258 2008/01/02 15:18:15 goba Exp $
 
 /**
- * @defgroup form Form generation
+ * @defgroup forms Form builder functions
+ * @{
+ * Functions that build an abstract representation of a HTML form.
+ *
+ * All core modules should declare their form builder functions to be in this
+ * group and each builder function should reference its validate and submit
+ * functions using \@see. Conversely, validate and submit functions should 
+ * reference the form builder function using \@see. For examples, of this see
+ * system_modules_uninstall() or user_pass(), the latter of which has the 
+ * following in its doxygen documentation:
+ *
+ * \@ingroup forms
+ * \@see user_pass_validate().
+ * \@see user_pass_submit().
+ *
+ * @} End of "defgroup forms".
+ */
+
+/**
+ * @defgroup form_api Form generation
  * @{
  * Functions to enable the processing and display of HTML forms.
  *
@@ -2205,7 +2224,7 @@ function form_clean_id($id = NULL, $flus
 }
 
 /**
- * @} End of "defgroup form".
+ * @} End of "defgroup form_api".
  */
 
 /**