#215335 by jvandyk: fix user_login_submit() phpdoc

modules/user/user.module

@@ -1339,8 +1339,10 @@ function user_authenticate_finalize(&$edit) {
 }
 
 /**
- * A validate handler on the login form. Update user's login timestamp, fire
- * hook_user('login), and generate new session ID.
+ * Submit handler for the login form. Redirects the user to a page.
+ *
+ * The user is redirected to the My Account page. Setting the destination in
+ * the query string (as done by the user login block) overrides the redirect.
  */
 function user_login_submit($form, &$form_state) {
   global $user;