Dialog: Added note explaining that _on() is safe to use for shared handlers because...

diff --git a/ui/jquery.ui.dialog.js b/ui/jquery.ui.dialog.js
index 0669cd852674305a25024fe1bf470ed7bb38abd9..cbae739bf4a79ca7a13a82b1c8ae0258136484e7 100644 (file)
--- a/ui/jquery.ui.dialog.js
+++ b/ui/jquery.ui.dialog.js
@@ -757,6 +757,8 @@ $.widget( "ui.dialog", {
                if ( !this.document.data( "ui-dialog-overlays" ) ) {
 
                        // Prevent use of anchors and inputs
+                       // Using _on() for an event handler shared across many instances is
+                       // safe because the dialogs stack and must be closed in reverse order
                        this._on( this.document, {
                                focusin: function( event ) {
                                        if ( isOpening ) {