[documentation] [Documentation bug] #submit attribute not working as documented (not working at all)

[chx]

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

 Project:      Documentation
 Version:      <none>
 Component:    Developer Guide
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  ostolop
 Updated by:   chx
 Status:       active

this last minute change has not yet been incorporated into the form API
reference. It's rarely needed anyways...




chx



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

Sat, 06 May 2006 21:28:07 +0000 : ostolop

Attachment: http://drupal.org/files/issues/form.inc_19.patch (812 bytes)

Forms API reference (forms_api_reference.html...) says:


#submit
Used by: button, submit
Description: Indicates whether or not button should submit the form.
Values: TRUE or FALSE


However, in forms.inc we have, in theme_button
(http://drupaldocs.org/api/head/function/theme_button), the 'submit'
type is hardcoded. A simple patch is attached to use the #submit
attribute (if set, otherwise continue using the 'submit' type).




------------------------------------------------------------------------

Sat, 06 May 2006 22:05:04 +0000 : chx

#submit as been renamed to executes_submit_callback. Nothing to change
here.




------------------------------------------------------------------------

Sat, 13 May 2006 19:58:15 +0000 : ostolop

Oh... sorry about sounding ignorant, but is this documented anywhere?
How could one have found out about this?




------------------------------------------------------------------------

Sat, 13 May 2006 20:24:51 +0000 : pwolanin

I second the question (and reassigned this as a documentation bug).   
Is the Forms API reference invalid for 4.7 or only for HEAD/4.8?  


BTW, on api.drupal.org, this attribute is still listed, but does not
link to anything:


ibutions/docs/developer/topics/forms_api_reference.html#submit_property...


gives a page not found error.