Currently, Forms API properties (keys for
$form_state) are documented above both
drupal_build_form(), which adds significant duplication. Furthermore, many properties are not documented.
Move documentation of all properties to
drupal_build_form(), and add documentation for the undocumented properties. includes these changes along with some additional cleanup for this doxygen block.
- The current patch is for D8 only. Consider this for D7 backport once the D8 issue is resolved. (Some changes that will be needed for D7 are in .)
- Commit this patch first, then consider future improvements or corrections. E.g., once committed, a new patch against the documentation will be needed.
User interface changes
Original report by @rfay
This patch adds a doxy snippet copied from drupal_build_form() into the consolidated $form_state documentation.
We missed this somehow when doing that section.
PASSED: [[SimpleTest]]: [MySQL] 36,456 pass(es).
PASSED: [[SimpleTest]]: [MySQL] 36,473 pass(es).
FAILED: [[SimpleTest]]: [MySQL] Unable to apply patch d8_form_state_keys-859970-27.patch. This may be a -p0 (old style) patch, which is no longer supported by the testbots.
PASSED: [[SimpleTest]]: [MySQL] 30,016 pass(es).