[compiz] Return value from an action function

[Mike Dransfield]

I had always assumed that an action option
should return true if it handles the action,
but it seems like most button bindings actually
return false which causes a few problems.

1. The clicks pass through to windows which
is not good for rotate, screenshot or annotate.

2. I am trying to add a generic action notification
which plugins can wrap to see when other actions
are initiated and terminated.  Some plugins like 3D
'react' to the cube being rotated manually but not
when keyboard initiated.

I came to the conclusion that the best place for
it to go would be in the handleEvent function.

If the trigger*Binding function returns true
then it should send the notification, but this
does not return true even if the action initiated
because they are returning false.

Is there is reason for this?  If so can you explain
exactly what returning true/false means.

Regards
Mike