make JS update comment more descriptive (english)

IPython/html/static/notebook/js/widgets/widget.js

@@ -269,8 +269,13 b' function(widget_manager, underscore, backbone){'
         },
     
         update: function () {
-            // the very first update seems to happen before the element is finished rendering
-            // so we use setTimeout to give the element time to render
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+            //      The very first update seems to happen before the element is 
+            // finished rendering so we use setTimeout to give the element time 
+            // to render
             var e = this.$el;
             var visible = this.model.get('visible');
             setTimeout(function() {e.toggle(visible)},0);

IPython/html/static/notebook/js/widgets/widget_bool.js

@@ -44,9 +44,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             if (!this.user_invoked_update) {
                 this.$checkbox.prop('checked', this.model.get('value'));
 
@@ -84,9 +86,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             if (!this.user_invoked_update) {
                 if (this.model.get('value')) {
                     this.$button.addClass('active');

IPython/html/static/notebook/js/widgets/widget_button.js

@@ -30,9 +30,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             var description = this.model.get('description');
             description = description.replace(/ /g, ' ', 'm');
             description = description.replace(/\n/g, '<br>\n', 'm');

IPython/html/static/notebook/js/widgets/widget_container.js

@@ -69,6 +69,10 b' define(["notebook/js/widgets/widget"], function(widget_manager) {'
         },
         
         update: function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             set_flex_properties(this, this.$el);
             return IPython.DOMWidgetView.prototype.update.call(this);
         },
@@ -225,6 +229,10 b' define(["notebook/js/widgets/widget"], function(widget_manager) {'
         },
         
         update: function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             set_flex_properties(this, this.$body);
             
             var description = this.model.get('description');

IPython/html/static/notebook/js/widgets/widget_float_range.js

@@ -44,9 +44,12 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+
             // Slider related keys.
             var _keys = ['step', 'max', 'min', 'disabled'];
             for (var index in _keys) {
@@ -135,9 +138,12 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+
             var value = this.model.get('value');
             if (!this.changing && parseFloat(this.$textbox.val()) != value) {
                 this.$textbox.val(value);
@@ -230,9 +236,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             var value = this.model.get('value');
             var max = this.model.get('max');
             var min = this.model.get('min');

IPython/html/static/notebook/js/widgets/widget_image.js

@@ -26,9 +26,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             var image_src = 'data:image/' + this.model.get('image_format') + ';base64,' + this.model.get('_b64value');
             this.$el.attr('src', image_src);
             

IPython/html/static/notebook/js/widgets/widget_int_range.js

@@ -18,7 +18,7 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
     var IntRangeWidgetModel = IPython.WidgetModel.extend({});
     widget_manager.register_widget_model('IntRangeWidgetModel', IntRangeWidgetModel);
 
-    var IntSliderView = IPython.WidgetView.extend({
+    var IntSliderView = IPython.DOMWidgetView.extend({
         
         // Called when view is rendered.
         render : function(){
@@ -44,9 +44,12 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+
             // Slider related keys.
             var _keys = ['step', 'max', 'min', 'disabled'];
             for (var index in _keys) {
@@ -102,7 +105,7 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
                 this.$label.html(description);
                 this.$label.show();
             }
-            return IPython.WidgetView.prototype.update.call(this);
+            return IPython.DOMWidgetView.prototype.update.call(this);
         },
         
         // Handles: User input
@@ -115,7 +118,7 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
 
     widget_manager.register_widget_view('IntSliderView', IntSliderView);
 
-    var IntTextView = IPython.WidgetView.extend({
+    var IntTextView = IPython.DOMWidgetView.extend({
         
         // Called when view is rendered.
         render : function(){
@@ -134,9 +137,12 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+
             var value = this.model.get('value');
             if (!this.changing && parseInt(this.$textbox.val()) != value) {
                 this.$textbox.val(value);
@@ -155,7 +161,7 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
                 this.$label.html(description);
                 this.$label.show();
             }
-            return IPython.WidgetView.prototype.update.call(this);
+            return IPython.DOMWidgetView.prototype.update.call(this);
         },
         
         

IPython/html/static/notebook/js/widgets/widget_multicontainer.js

@@ -45,6 +45,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
         
 
         update: function() {
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+
             // Set tab titles
             var titles = this.model.get('_titles');
             for (var page_index in titles) {
@@ -153,6 +158,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
         },
 
         update: function() {
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
+            
             // Set tab titles
             var titles = this.model.get('_titles');
             for (var page_index in titles) {

IPython/html/static/notebook/js/widgets/widget_selection.js

@@ -55,9 +55,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
 
             var selected_item_text = this.model.get('value');
             selected_item_text = selected_item_text.replace(/ /g, ' ');
@@ -129,9 +131,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             
             // Add missing items to the DOM.
             var items = this.model.get('values');
@@ -216,9 +220,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             
             // Add missing items to the DOM.
             var items = this.model.get('values');
@@ -298,9 +304,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update();
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             
             // Add missing items to the DOM.
             var items = this.model.get('values');

IPython/html/static/notebook/js/widgets/widget_string.js

@@ -25,9 +25,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             this.$el.html(this.model.get('value'));
             return IPython.DOMWidgetView.prototype.update.call(this);
         },
@@ -44,9 +46,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update : function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             this.$el.html(this.model.get('value'));
             MathJax.Hub.Queue(["Typeset",MathJax.Hub,this.$el.get(0)]);
 
@@ -91,9 +95,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
         },
 
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update: function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             if (!this.user_invoked_update) {
                 this.$textbox.val(this.model.get('value'));
             }
@@ -145,9 +151,11 b' define(["notebook/js/widgets/widget"], function(widget_manager){'
             this.update(); // Set defaults.
         },
         
-        // Handles: Backend -> Frontend Sync
-        //          Frontent -> Frontend Sync
         update: function(){
+            // Update the contents of this view
+            //
+            // Called when the model is changed.  The model may have been 
+            // changed by another view or by a state update from the back-end.
             if (this.$textbox.val() != this.model.get('value')) {
                 this.$textbox.val(this.model.get('value'));
             }