Specify how to detach `dblclick()` event handler

[jhfrench]

The documentation at https://api.jquery.com/dblclick/ describes how to attach the dblclick() method.

Unlike other event listener bindings, like on(), bind(), delegate(), and live() the dblclick() documentation does not specify the best way to remove the binding (ie, "To remove events bound with .on(), see .off().").

I assume, based on the "This method is a shortcut for .on( "dblclick", handler)..." note, that the correct way to detach the dblclick() event listener is to use off("dblclick").

[arthurvr]

Going to wait for other feedback, but I don't think it's needed. Other shorthand methods, such as click, don't mention this as well. I think if that's possible we should avoid unnecessary things and keep the pages as slim as possible (definitely pages for shorthand methods).

That said, the pages states that .dblclick() is shorthand for .on() and on the on() entry it is actually explained.

[jhfrench]

@arthurvr Understood.

That said, I'm making this suggestion becaues I have encountered some ambiguity about the best way to detach dblclick(); I came across this issue while maintaining code which used unbind().

For the same reasons it is useful to link off() with on(), it it is useful to link off() with the on() shorthand children like dblclick(), click(), etc--particularly for jQuery newbies, and pedants like me, who can be understood to prefer explicit instructions over extrapolated guidance.

[arthurvr]

particularly for jQuery newbies who can be understood to need explicit guidance.

That sentence makes me think it's more likely something we need to clarify on learn.jquery.com. WDYT?

[dmethvin]

Also, I think of the "shorthand" attachment methods as archaic, it's better to use .on() and .off() for everything so this kind of confusion doesn't happen in the first place. If people agree perhaps we could just add a reusable note to all of them. Since the method name is the event name, we should be able to use some of that funky XML templating magic to put in the note that @jhfrench is asking to add?

[arthurvr]

Since the method name is the event name, we should be able to use some of that funky XML templating magic to put in the note that @jhfrench is asking to add?

Yup, that's definitely no problem.

[kswedberg]

+:100: to reusable note, @dmethvin

[arthurvr]

There we go: #719. Feedback welcome ;)

[jhfrench]

Sweet. Love it. Thanks.