Use PySide Slot decorator instead of SLOT docstring.

* Use PySide Slot decorator instead of SLOT docstring.
* Use consistent wording for triggers documentation.
* Improve parameters docstrings.
* Rename a parameter named 'param' to a more meaningful 'idx'.

Closes #5506.