Ticket #35465: 35465.6.diff

src/wp-includes/js/wp-backbone.js

@@ -197 +197 @@
                  * @since 3.5.0
                  *
                  * @param {string}       selector A jQuery selector.
-                 * @param {array|object} views    The subviews for the main view.
+                 * @param {array|Object} views    The subviews for the main view.
                  * @param {Object}       options  Options for call.  To insert `views` at a
                  *                                specific index, use `options.at`. If
                  *                                `options.silent` is true, no DOM modifications
@@ -273 +273 @@
                 },
 
                 /**
-                 * Renders all subviews
+                 * Renders all subviews.
                  *
                  * Used in conjunction with `Views.detach()`.
                  *
@@ -295 +295 @@
                 },
 
                 /**
-                 * Removes all subviews
+                 * Removes all subviews.
                  *
                  * Triggers the `remove()` method on all subviews. Detaches the master
                  * view from its parent. Resets the internals of the views manager.
@@ -344 +344 @@
                 },
 
                 /**
-                 * Insert subviews into a selector
+                 * Insert subviews into a selector.
                  *
                  * By default, appends the subview `els` to the end of the `$target`
                  * selector. If `options.at` is set, inserts the subview `els` at the
@@ -404 +404 @@
                  *
                  * @private
                  *
-                 * @param {string}       selector A jQuery selector.
-                 * @param {array|object} views    The subviews for the main view.
-                 * @param {Object}       options  Options for call.
-                 * @param {boolean}      options.add  If true the provided views will be added.
+                 * @param {string}       selector    A jQuery selector.
+                 * @param {array|object} views       The subviews for the main view.
+                 * @param {Object}       options     Options for call.
+                 * @param {boolean}      options.add If true the provided views will be added.
                  *
                  * @return {wp.Backbone.Subviews} The current Subviews instance.
                  */
@@ -433 +433 @@
                         // Insert or replace the views.
                         this[ options.add ? 'insert' : 'replace' ]( $selector, _.pluck( views, 'el' ), options );
 
-                        // Set attached and trigger ready if the current view is already
-                        // attached to the DOM.
+                        /*
+                         * Set attached and trigger ready if the current view is already
+                         * attached to the DOM.
+                         */
                         _.each( managers, function( manager ) {
                                 manager.attached = true;
 
@@ -452 +454 @@
                  *
                  * @private
                  *
-                 * @returns {boolean} Whether or not the current view is in the DOM.
+                 * @return {boolean} Whether or not the current view is in the DOM.
                  */
                 _isReady: function() {
                         var node = this.view.el;