event-helpers.md .toggle description inconsistent with API docs

[mjparrott]

On the event helpers section of learn.jquery.com, it says the .toggle function is to be given 2 or more functions that are called when an onclick event occurs.

However, the .toggle method description in the documentation talks about it being used to toggle the visibility of elements.

It looks like the first usage was deprecated in 1.8 and removed in 1.9, so this should probably be updated to show its newer usage.

See:
http://api.jquery.com/toggle-event/
http://api.jquery.com/toggle/
http://learn.jquery.com/events/event-helpers/

[AurelioDeRosa]

This is a very old issue but the page still discusses about .toggle(). While it asserts the method has been removed in jQuery 1.9, the example is still there. I think it should be completely removed. What do you all think?

[mgol]

Yeah, we shouldn't teach people how to write code using deprecated features. ;)

[arthurvr]

PR: #529.