Offshoot of #1168888: 'complete form' key missing from $form_state documentation

a) We have $form_state documented in two places in D7/8:
Form Generation topic - http://api.drupal.org/api/drupal/includes--form.inc/group/form_api/7
drupal_build_form() function - http://api.drupal.org/api/drupal/includes--form.inc/function/drupal_buil...
We should have it documented in just one of those two places (not sure which) with the other linking to the documentation spot.

b) The two lists of components don't currently match, and I think both of them are incomplete (plus they may have extra components that don't exist in $form_state at all). Someone needs to go through drupal_build_form and drupal_get_form and figure out what is being put into $form_state, and make sure that these components, and only these components, are documented. And compare the component descriptions currently present in these two spots, keeping the better one of the two (or writing an even better one if the description is lacking).

In specific, I noticed that 'method' is missing as a component. There are probably others.

Comments

jn2’s picture

Status: Active » Closed (duplicate)

This issue is a duplicate of #859970: Cleanup form_api $form_state docs - keys in 2 places, missing some. rfay is already working on a patch.