Improve JavaDoc on @EditorAction

The JavaDoc had no information about the return value of the listener
method, now this is added.
Merge pull request #1150 from WonderCsabo/1148_improveEditorActionDoc

Improve JavaDoc on @EditorAction