Lots of form attributes specify callbacks. The description should give the function parameters.

#element_validate is a good model to follow.

Attributes missing function parameters include #theme and #process.

Comments

aspilicious’s picture

aspilicious commented
Version: 7.x-dev » 8.x-dev
Issue tags: +Needs documentation

jhodgdon will have an answer on this question.

jn2’s picture

jn2 commented
Issue tags: -Needs documentation +FAPI reference

Tags

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Project: Drupal core » Documentation
Version: 8.x-dev »
Component: documentation » API documentation files

I think we should probably postpone this for the time being. We need to focus our efforts on figuring out how to get this automatically generated. Sigh.

jn2’s picture

jn2 commented

@jhodgdon
Friday morning, looked for you on IRC to discuss, but you must be busy.

See my post at http://drupal.org/node/100680#comment-4649760. (Crazy, huh?)

sun’s picture

sun
Primary language German
Location Karlsruhe
commented

subscribing, just in case there's something to review here. Also happy to review a patch against the FAPI reference doc.

jn2’s picture

jn2 commented

@sun

Patches don't work well against the FAPI reference. I've been editing directly, then pushing. If someone gives me most of the information I need, I include their name in the commit message.

There's an issue to document the 'container' element #1169954: FAPI container element is not documented that could really use your attention. It's not exactly a patch, but it includes what I will put into the document. If you review comment #6, I'll incorporate the results into the edit and include you in the commit.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Issue tags: +valid issue

Tagging so #1421874: [meta] Documentation Issue Queue Cleanup doesn't have to look at API docs issues.

quietone’s picture

quietone commented
Issue summary: View changes
Status: Active » Closed (won't fix)
Issue tags: -

Thanks for working to improve Drupal.

This is for the Drupal 7 Form API reference. Since Drupal 7 is past end-of-life this is now a "won't fix".

Work on documentation for form elements for supported versions of Drupal is at #2486967: [meta] Move/Create Form Element Documentation and #3313535: [Meta] Improve documentation for Render and Form Elements.