#submit wrong documented in form api reference.

http://api.drupal.org/api/4.7/file/developer/topics/forms_api_reference.... explains it is a BOOL, that can be true or false. In reality it is a callback-container.

From IRC:
[17:43] <berkes> does anyone know what this is about? $form['#submit'] = array('logintoboggan_user_register_submit' => array($form_id, &$form_values));
[17:44] <merlinofchaos> berkes: It's adding an extra submit handler.
[17:44] <berkes> acc to the fapi reference $form['#submit'] is a bool, TRUE or false
[17:44] <merlinofchaos> I think the bool is now #form_submitted
[17:44] <berkes> I am talking about 4.7
[17:45] <merlinofchaos> Same there
[17:45] <merlinofchaos> Tho it may just be #submitted
[17:45] <berkes> hmm, then http://api.drupal.org/api/4.7/file/developer/topics/forms_api_reference.... is wrong
[17:46] <berkes> but, that submit handler, in logintoboggan, logintoboggan_user_register_submit has a *return* value, what does FAPI do with that?
[17:47] <merlinofchaos> drupal_goto
[17:48] <berkes> merlinofchaos: cool. So is there a way to pass not just a $path to drupal godo, but a $query (and fragment) too?
[17:48] <merlinofchaos> Yes, return an array
[17:49] <merlinofchaos> the array should match the url() args
[17:49] <berkes> cool. that will help me a lot. Thanks.

I think this is more then clear enough. It is a trick that is VERY important for FAPI, in fact it is one of the most powerfull parts, yet its not even documented!