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. #859970-27: Cleanup form_api $form_state docs - keys in 2 places, missing some 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 #859970-30: Cleanup form_api $form_state docs - keys in 2 places, missing some.)
- Commit this patch first, then consider future improvements or corrections. E.g., once #597108: Consistent array key syntax in $form_state (underscores vs. spaces) 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.