Improved the phpdoc of form actions on elements to describe the behavior

Refs #526