added third parameter: `immediate_click_callback`: always invoke the 'immediate click' handler: that way we allow userland code to perform some very specific tweaks that we cannot do for them (domain knowledge of the userland app required).
updating the documentation.