Widget: Document return value of _trigger. Fixes #168 - Base widget _tri...

[jzaefferer]

...gger: Return value undocumented

[tjvantoll]

false is in <code> blocks on the first usage but not the second.

[tjvantoll]

Can't _trigger invoke multiple callbacks? This isn't necessarily related to your change; all the docs for this method seem to think there's one callback.

[scottgonzalez]

There can be many event handlers, but only one callback. The callback is provided by an option. Other than the one formatting issue @tjvantoll pointed out, this looks good to me.

[scottgonzalez]

Actually, to avoid the confusion, and describe the behavior more semantically, perhaps something like "If the default action is prevented..." or "The return value indicates whether the default action should take place."

[jzaefferer]

I've updated this, rewording the description as suggested.

[scottgonzalez]

Looks good.

[tjvantoll]

+1