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

Refs #526
Merge pull request #553 from stof/phpdoc

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