[documentation] [Documentation bug] #submit wrong documented in form api reference.

[webchick]

Issue status update for 
http://drupal.org/node/112398
Post a follow up: 
http://drupal.org/project/comments/add/112398

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  Bèr Kessels
 Updated by:   webchick
 Status:       active

Anyone with CVS access can fix this. The document is located in
docs/developer/topics/forms_api_reference.html.




webchick



Previous comments:
------------------------------------------------------------------------

Wed, 24 Jan 2007 16:56:35 +0000 : Bèr Kessels

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!