Index: modules/system/system.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.api.php,v
retrieving revision 1.27
diff -u -r1.27 system.api.php
--- modules/system/system.api.php	21 Apr 2009 05:07:08 -0000	1.27
+++ modules/system/system.api.php	27 Apr 2009 23:01:34 -0000
@@ -242,8 +242,8 @@
  * One popular use of this hook is to add form elements to the node form. When
  * altering a node form, the node object retrieved at from $form['#node'].
  *
- * Note that you can also use hook_FORM_ID_alter() to alter a specific form,
- * instead of this hook, which gets called for all forms.
+ * Note that instead of hook_form_alter(), which is called for all forms, you 
+ * can also use hook_form_FORM_ID_alter() to alter a specific form.
  *
  * @param $form
  *   Nested array of form elements that comprise the form.
@@ -252,8 +252,6 @@
  * @param $form_id
  *   String representing the name of the form itself. Typically this is the
  *   name of the function that generated the form.
- * @return
- *   None.
  */
 function hook_form_alter(&$form, $form_state, $form_id) {
   if (isset($form['type']) && $form['type']['#value'] . '_node_settings' == $form_id) {