Update event docs with 1.7 $.fn.on recommendations

[johnbender]

Since we're supporting 1.7 we should include clarification about the migration to $.fn.on along side our info about $.fn.live since we support 1.6.4.

[jaspermdegroot]

@toddparker - until when do we keep supporting jQuery 1.6.4? I was thinking about the examples we are going to add to the docs and having to show two versions of code because of .live()/.on()

[toddparker]

I think we'll need to support 1.6.4 for at least a few more dot releases. Who wants to take a crack at adding these doc notes?

[gabrielschulhof]

Actually, we've dropped support for 1.6.4 in 1.2.0 ... we claim to support core 1.7.0 through 1.8.2 ...

[gabrielschulhof]

So, .on()/.off() is the only way now.

[jaspermdegroot]

besides the docs we should at the code where we still use bind() and delegate()

[gabrielschulhof]

Fixed in the API documentation in 9edaa03 with the script below:

find entries  | grep '\.xml$' | xargs grep -nH '\.bind' | \
  awk -F ':' '{print $1;}' | while read; do
    cat $REPLY | sed 's/\.bind/.on/g' > $REPLY.new && mv $REPLY.new $REPLY;
  done