Update formhelper docs

Do a few fixes to the form helper docs. Related to cakephp/cakephp#5006 and cakephp/cakephp#5003
... widgets *should* be displayed.