Drupal.org

Documentation problem with forms_api_reference.html: give function params for all callbacks

Project:Documentation
Component:API documentation files
Category:bug report
Priority:normal
Assigned:Unassigned
Status:active
Issue tags:FAPI reference, valid issue

Issue Summary

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

#1

Version:7.x-dev» 8.x-dev

jhodgdon will have an answer on this question.

#2

#3

Project:Drupal core» Documentation
Version:8.x-dev» <none>
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.

#4

@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?)

#5

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

#6

@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.

#7

Issue tags:+valid issue

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

nobody click here