Ticket #41682: jsdoc-namespaces.5.patch

Gruntfile.js

@@ -420 +420 @@
                                 }
                         }
                 },
+                jsdoc : {
+                        dist : {
+                                dest: 'jsdoc',
+                                options: {
+                                        configure : 'jsdoc.conf.json'
+                                }
+                        }
+                },
                 qunit: {
                         files: [
                                 'tests/qunit/**/*.html',

new file jsdoc.conf.json

@@ +1 @@
+{
+        "plugins": [],
+        "recurseDepth": 10,
+        "source": {
+        "include": ["src/wp-includes/js"],
+        "exclude": [
+            "src/wp-includes/js/tinymce",
+            "src/wp-includes/js/crop",
+            "src/wp-includes/js/imgareaselect",
+            "src/wp-includes/js/jcrop",
+            "src/wp-includes/js/jquery",
+            "src/wp-includes/js/mediaelement",
+            "src/wp-includes/js/swfupload",
+            "src/wp-includes/js/thickbox",
+            "src/wp-includes/js/media-audiovideo.js",
+            "src/wp-includes/js/media-grid.js",
+            "src/wp-includes/js/media-models.js",
+            "src/wp-includes/js/media-views.js"
+        ],
+        "includePattern": ".+\\.js(doc|x)?$",
+        "excludePattern": "(^|\\/|\\\\)_"
+        },
+        "sourceType": "module",
+        "tags": {
+        "allowUnknownTags": true,
+        "dictionaries": ["jsdoc","closure"]
+        },
+        "templates": {
+        "cleverLinks": false,
+        "monospaceLinks": false,
+        "theme": "united",
+        "outputSourceFiles": true,
+        "outputSourcePath": true,
+        "linenums": true
+        },
+        "opts": {
+        "template": "./node_modules/ink-docstrap/template",
+        "recurse": true
+        }
+}

package.json

@@ -26 +26 @@
     "grunt-contrib-uglify": "~2.0.0",
     "grunt-contrib-watch": "~1.0.0",
     "grunt-includes": "~0.5.1",
+    "grunt-jsdoc": "^2.1.0",
     "grunt-jsvalidate": "~0.2.2",
     "grunt-legacy-util": "^0.2.0",
     "grunt-patch-wordpress": "~0.4.2",
@@ -33 +34 @@
     "grunt-replace": "~1.0.1",
     "grunt-rtlcss": "~2.0.1",
     "grunt-sass": "~1.2.1",
+    "ink-docstrap": "^1.3.0",
     "matchdep": "~1.0.0"
   }
 }

src/wp-includes/js/api-request.js

@@ -8 +8 @@
  * - Sends the REST API nonce as a request header.
  * - Allows specifying only an endpoint namespace/path instead of a full URL.
  *
- * @namespace wp.apiRequest
  * @since     4.9.0
  */
 
@@ -82 +81 @@
 
         apiRequest.transport = $.ajax;
 
+        /** @namespace wp */
         window.wp = window.wp || {};
         window.wp.apiRequest = apiRequest;
 } )( jQuery );

src/wp-includes/js/autosave.js

@@ -597 +597 @@
                 };
         }
 
+        /** @namespace wp */
         window.wp = window.wp || {};
         window.wp.autosave = autosave();
 

src/wp-includes/js/customize-base.js

@@ +1 @@
+/** @namespace wp */
 window.wp = window.wp || {};
 
 (function( exports, $ ){
@@ -165 +166 @@
         /**
          * Observable values that support two-way binding.
          *
+         * @memberOf wp.customize
+         * @alias wp.customize.Value
+         *
          * @constructor
          */
-        api.Value = api.Class.extend({
+        api.Value = api.Class.extend(/** @lends wp.customize.Value.prototype */{
                 /**
                  * @param {mixed}  initial The initial value.
                  * @param {object} options
@@ -304 +308 @@
         /**
          * A collection of observable values.
          *
+         * @memberOf wp.customize
+         * @alias wp.customize.Values
+         *
          * @constructor
          * @augments wp.customize.Class
          * @mixes wp.customize.Events
          */
-        api.Values = api.Class.extend({
+        api.Values = api.Class.extend(/** @lends wp.customize.Values.prototype */{
 
                 /**
                  * The default constructor for items of the collection.
@@ -520 +527 @@
          *
          * Handles inputs, selects, and textareas by default.
          *
+         * @memberOf wp.customize
+         * @alias wp.customize.Element
+         *
          * @constructor
          * @augments wp.customize.Value
          * @augments wp.customize.Class
          */
-        api.Element = api.Value.extend({
+        api.Element = api.Value.extend(/** @lends wp.customize.Element */{
                 initialize: function( element, options ) {
                         var self = this,
                                 synchronizer = api.Element.synchronizer.html,
@@ -617 +627 @@
         /**
          * A communicator for sending data from one window to another over postMessage.
          *
+         * @memberOf wp.customize
+         * @alias wp.customize.Messenger
+         *
          * @constructor
          * @augments wp.customize.Class
          * @mixes wp.customize.Events
          */
-        api.Messenger = api.Class.extend({
+        api.Messenger = api.Class.extend(/** @lends wp.customize.Messenger.prototype */{
                 /**
                  * Create a new Value.
                  *
@@ -765 +778 @@
          * @augments wp.customize.Class
          * @since 4.6.0
          *
+         * @memberOf wp.customize
+         * @alias wp.customize.Notification
+         *
          * @param {string}  code - The error code.
          * @param {object}  params - Params.
          * @param {string}  params.message=null - The error message.
@@ -773 +789 @@
          * @param {string}  [params.setting=null] - The setting ID that the notification is related to.
          * @param {*}       [params.data=null] - Any additional data.
          */
-        api.Notification = api.Class.extend({
+        api.Notification = api.Class.extend(/** @lends wp.customize.Notification.prototype */{
                 initialize: function( code, params ) {
                         var _params;
                         this.code = code;
@@ -798 +814 @@
         /**
          * Get all customize settings.
          *
+         * @memberOf wp.customize
+         *
          * @return {object}
          */
         api.get = function() {
@@ -812 +830 @@
 
         /**
          * Utility function namespace
+         *
+         * @namespace wp.customize.utils
          */
         api.utils = {};
 
@@ -820 +840 @@
          *
          * @since 4.7.0
          * @access public
+         * @memberOf wp.customize.utils
          *
          * @param {string} queryString Query string.
          * @returns {object} Parsed query string.
@@ -844 +865 @@
                 return queryParams;
         };
 
-        // Expose the API publicly on window.wp.customize
+        /**
+         * Expose the API publicly on window.wp.customize
+         *
+         * @namespace wp.customize
+         */
         exports.customize = api;
 })( wp, jQuery );

src/wp-includes/js/customize-loader.js

@@ -1 +1 @@
 /* global _wpCustomizeLoaderSettings, confirm */
-/*
+/**
  * Expose a public API that allows the customizer to be
  * loaded on any page.
+ *
+ * @namespace wp
  */
 window.wp = window.wp || {};
 
@@ -22 +24 @@
          *
          *     e.g. <a class="load-customize" href="<?php echo wp_customize_url(); ?>">Open Customizer</a>
          *
+         * @memberOf wp.customize
+         *
+         * @class
          * @augments wp.customize.Events
          */
-        Loader = $.extend( {}, api.Events, {
+        Loader = $.extend( {}, api.Events,/** @lends wp.customize.Loader.prototype */{
                 /**
                  * Setup the Loader; triggered on document#ready.
                  */

src/wp-includes/js/customize-models.js

@@ -1 +1 @@
 /* global _wpCustomizeHeader */
 (function( $, wp ) {
         var api = wp.customize;
+        /** @namespace wp.customize.HeaderTool */
         api.HeaderTool = {};
 
 
@@ -13 +14 @@
          * These calls are made regardless of whether the user actually saves new
          * Customizer settings.
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.ImageModel
+         *
          * @constructor
          * @augments Backbone.Model
          */
-        api.HeaderTool.ImageModel = Backbone.Model.extend({
+        api.HeaderTool.ImageModel = Backbone.Model.extend(/** @lends wp.customize.HeaderTool.ImageModel.prototype */{
                 defaults: function() {
                         return {
                                 header: {
@@ -125 +129 @@
         /**
          * wp.customize.HeaderTool.ChoiceList
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.ChoiceList
+         *
          * @constructor
          * @augments Backbone.Collection
          */
@@ -232 +239 @@
         /**
          * wp.customize.HeaderTool.DefaultsList
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.DefaultsList
+         *
          * @constructor
          * @augments wp.customize.HeaderTool.ChoiceList
          * @augments Backbone.Collection

src/wp-includes/js/customize-preview-nav-menus.js

@@ -1 +1 @@
 /* global _wpCustomizePreviewNavMenusExports */
+
+/** @namespace wp.customize.navMenusPreview */
 wp.customize.navMenusPreview = wp.customize.MenusCustomizerPreview = ( function( $, _, wp, api ) {
         'use strict';
 
@@ -72 +74 @@
                 /**
                  * Partial representing an invocation of wp_nav_menu().
                  *
+                 * @memberOf wp.customize.navMenusPreview
+                 * @alias wp.customize.navMenusPreview.NavMenuInstancePartial
+                 *
                  * @class
                  * @augments wp.customize.selectiveRefresh.Partial
                  * @since 4.5.0
                  */
-                self.NavMenuInstancePartial = api.selectiveRefresh.Partial.extend({
+                self.NavMenuInstancePartial = api.selectiveRefresh.Partial.extend(/** @lends wp.customize.navMenusPreview.NavMenuInstancePartial.prototype */{
 
                         /**
                          * Constructor.

src/wp-includes/js/customize-preview-widgets.js

@@ -1 +1 @@
 /* global _wpWidgetCustomizerPreviewSettings */
+
+/** @namespace wp.customize.widgetsPreview */
 wp.customize.widgetsPreview = wp.customize.WidgetCustomizerPreview = (function( $, _, wp, api ) {
 
         var self;
@@ -42 +44 @@
         /**
          * Partial representing a widget instance.
          *
+         * @memberOf wp.customize.widgetsPreview
+         * @alias wp.customize.widgetsPreview.WidgetPartial
+         *
          * @class
          * @augments wp.customize.selectiveRefresh.Partial
          * @since 4.5.0
          */
-        self.WidgetPartial = api.selectiveRefresh.Partial.extend({
+        self.WidgetPartial = api.selectiveRefresh.Partial.extend(/** @lends wp.customize.widgetsPreview.WidgetPartial.prototype */{
 
                 /**
                  * Constructor.
@@ -112 +117 @@
         /**
          * Partial representing a widget area.
          *
+         * @memberOf wp.customize.widgetsPreview
+         * @alias wp.customize.widgetsPreview.SidebarPartial
+         *
          * @class
          * @augments wp.customize.selectiveRefresh.Partial
          * @since 4.5.0
          */
-        self.SidebarPartial = api.selectiveRefresh.Partial.extend({
+        self.SidebarPartial = api.selectiveRefresh.Partial.extend(/** @lends wp.customize.widgetsPreview.SidebarPartial.prototype */{
 
                 /**
                  * Constructor.
@@ -510 +518 @@
         /**
          * Calculate the selector for the sidebar's widgets based on the registered sidebar's info.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 3.9.0
          */
         self.buildWidgetSelectors = function() {
@@ -548 +558 @@
         /**
          * Highlight the widget on widget updates or widget control mouse overs.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 3.9.0
          * @param  {string} widgetId ID of the widget.
          */
@@ -567 +579 @@
          * Show a title and highlight widgets on hover. On shift+clicking
          * focus the widget control.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 3.9.0
          */
         self.highlightControls = function() {
@@ -598 +612 @@
         /**
          * Parse a widget ID.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 4.5.0
          *
          * @param {string} widgetId Widget ID.
@@ -623 +639 @@
         /**
          * Parse a widget setting ID.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 4.5.0
          *
          * @param {string} settingId Widget setting ID.
@@ -648 +666 @@
         /**
          * Convert a widget ID into a Customizer setting ID.
          *
+         * @memberOf wp.customize.widgetsPreview
+         *
          * @since 4.5.0
          *
          * @param {string} widgetId Widget ID.

src/wp-includes/js/customize-preview.js

@@ -87 +87 @@
         };
 
         /**
+         * @memberOf wp.customize
+         * @alias wp.customize.Preview
+         *
          * @constructor
          * @augments wp.customize.Messenger
          * @augments wp.customize.Class
          * @mixes wp.customize.Events
          */
-        api.Preview = api.Messenger.extend({
+        api.Preview = api.Messenger.extend(/** @lends wp.customize.Preview.prototype */{
                 /**
                  * @param {object} params  - Parameters to configure the messenger.
                  * @param {object} options - Extend any instance parameter or method with this object.

src/wp-includes/js/customize-selective-refresh.js

@@ -1 +1 @@
 /* global jQuery, JSON, _customizePartialRefreshExports, console */
 
+/** @namespace wp.customize.selectiveRefresh */
 wp.customize.selectiveRefresh = ( function( $, api ) {
         'use strict';
         var self, Partial, Placement;
@@ -24 +25 @@
          *
          * A partial provides a rendering of one or more settings according to a template.
          *
+         * @memberOf wp.customize.selectiveRefresh
+         *
          * @see PHP class WP_Customize_Partial.
          *
          * @class
@@ -39 +42 @@
          * @param {string} options.params.primarySetting   The ID for the primary setting the partial renders.
          * @param {bool}   options.params.fallbackRefresh  Whether to refresh the entire preview in case of a partial refresh failure.
          */
-        Partial = self.Partial = api.Class.extend({
+        Partial = self.Partial = api.Class.extend(/** @lends wp.customize.SelectiveRefresh.Partial.prototype */{
 
                 id: null,
 
@@ -508 +511 @@
          * It also may have information in relation to how a placement may have just changed.
          * The placement is conceptually similar to a DOM Range or MutationRecord.
          *
-         * @class
+         * @memberOf wp.customize.selectiveRefresh
+         *
+         * @class Placement
          * @augments wp.customize.Class
          * @since 4.5.0
          */
-        self.Placement = Placement = api.Class.extend({
+        self.Placement = Placement = api.Class.extend(/** @lends wp.customize.selectiveRefresh.prototype */{
 
                 /**
                  * The partial with which the container is associated.

src/wp-includes/js/customize-views.js

@@ -11 +11 @@
          *
          * Instantiate with model wp.customize.HeaderTool.currentHeader.
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.CurrentView
+         *
          * @constructor
          * @augments wp.Backbone.View
          */
-        api.HeaderTool.CurrentView = wp.Backbone.View.extend({
+        api.HeaderTool.CurrentView = wp.Backbone.View.extend(/** @lends wp.customize.HeaderTool.CurrentView.prototype */{
                 template: wp.template('header-current'),
 
                 initialize: function() {
@@ -50 +53 @@
          * Manually changes model wp.customize.HeaderTool.currentHeader via the
          * `select` method.
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.ChoiceView
+         *
          * @constructor
          * @augments wp.Backbone.View
          */
-        api.HeaderTool.ChoiceView = wp.Backbone.View.extend({
+        api.HeaderTool.ChoiceView = wp.Backbone.View.extend(/** @lends wp.customize.HeaderTool.ChoiceView.prototype */{
                 template: wp.template('header-choice'),
 
                 className: 'header-view',
@@ -125 +131 @@
          *
          * Takes a wp.customize.HeaderTool.ChoiceList.
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.ChoiceListView
+         *
          * @constructor
          * @augments wp.Backbone.View
          */
-        api.HeaderTool.ChoiceListView = wp.Backbone.View.extend({
+        api.HeaderTool.ChoiceListView = wp.Backbone.View.extend(/** @lends wp.customize.HeaderTool.ChoiceListView.prototype */{
                 initialize: function() {
                         this.listenTo(this.collection, 'add', this.addOne);
                         this.listenTo(this.collection, 'remove', this.render);
@@ -168 +177 @@
          * Aggregates wp.customize.HeaderTool.ChoiceList collections (or any
          * Backbone object, really) and acts as a bus to feed them events.
          *
+         * @memberOf wp.customize.HeaderTool
+         * @alias wp.customize.HeaderTool.CombinedList
+         *
          * @constructor
          * @augments wp.Backbone.View
          */
-        api.HeaderTool.CombinedList = wp.Backbone.View.extend({
+        api.HeaderTool.CombinedList = wp.Backbone.View.extend(/** @lends wp.customize.HeaderTool.CombinedList.prototype */{
                 initialize: function(collections) {
                         this.collections = collections;
                         this.on('all', this.propagate, this);

src/wp-includes/js/heartbeat.js

@@ -742 +742 @@
                 };
         };
 
-        // Ensure the global `wp` object exists.
+        /**
+         * Ensure the global `wp` object exists.
+         *
+         * @namespace wp
+         */
         window.wp = window.wp || {};
         window.wp.heartbeat = new Heartbeat();
 

src/wp-includes/js/mce-view.js

@@ -280 +280 @@
 
         wp.mce.View.extend = Backbone.View.extend;
 
-        _.extend( wp.mce.View.prototype, {
+        _.extend( wp.mce.View.prototype, /** @lends wp.mce.View.prototype */{
 
                 /**
                  * The content.

src/wp-includes/js/media-audiovideo.js

@@ -216 +216 @@
 media.view.VideoDetails = require( './views/video-details.js' );
 
 },{"./controllers/audio-details.js":2,"./controllers/video-details.js":3,"./models/post-media.js":4,"./views/audio-details.js":5,"./views/frame/audio-details.js":6,"./views/frame/media-details.js":7,"./views/frame/video-details.js":8,"./views/media-details.js":9,"./views/video-details.js":10}],2:[function(require,module,exports){
+var State = wp.media.controller.State,
+        l10n = wp.media.view.l10n,
+        AudioDetails;
+
 /**
  * wp.media.controller.AudioDetails
  *
  * The controller for the Audio Details state
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var State = wp.media.controller.State,
-        l10n = wp.media.view.l10n,
-        AudioDetails;
-
-AudioDetails = State.extend({
+AudioDetails = State.extend(/** @lends wp.media.controller.AudioDetails.prototype */{
         defaults: {
                 id: 'audio-details',
                 toolbar: 'audio-details',
@@ -254 +256 @@
  *
  * The controller for the Video Details state
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -262 +266 @@
         l10n = wp.media.view.l10n,
         VideoDetails;
 
-VideoDetails = State.extend({
+VideoDetails = State.extend(/** @lends wp.media.controller.VideoDetails.prototype */{
         defaults: {
                 id: 'video-details',
                 toolbar: 'video-details',
@@ -288 +292 @@
  * Shared model class for audio and video. Updates the model after
  *   "Add Audio|Video Source" and "Replace Audio|Video" states return
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  */
-var PostMedia = Backbone.Model.extend({
+var PostMedia = Backbone.Model.extend(/** @lends wp.media.model.PostMedia.prototype */{
         initialize: function() {
                 this.attachment = false;
         },
@@ -324 +330 @@
 module.exports = PostMedia;
 
 },{}],5:[function(require,module,exports){
+var MediaDetails = wp.media.view.MediaDetails,
+        AudioDetails;
+
 /**
  * wp.media.view.AudioDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MediaDetails
  * @augments wp.media.view.Settings.AttachmentDisplay
@@ -335 +346 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MediaDetails = wp.media.view.MediaDetails,
-        AudioDetails;
-
-AudioDetails = MediaDetails.extend({
+AudioDetails = MediaDetails.extend(/** @lends wp.media.view.AudioDetails.prototype */{
         className: 'audio-details',
         template:  wp.template('audio-details'),
 
@@ -362 +370 @@
 module.exports = AudioDetails;
 
 },{}],6:[function(require,module,exports){
+var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
+        MediaLibrary = wp.media.controller.MediaLibrary,
+
+        l10n = wp.media.view.l10n,
+        AudioDetails;
+
 /**
  * wp.media.view.MediaFrame.AudioDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.MediaDetails
  * @augments wp.media.view.MediaFrame.Select
@@ -375 +391 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
-        MediaLibrary = wp.media.controller.MediaLibrary,
-
-        l10n = wp.media.view.l10n,
-        AudioDetails;
-
-AudioDetails = MediaDetails.extend({
+AudioDetails = MediaDetails.extend(/** @lends wp.media.view.MediaFrame.AudioDetails.prototype */{
         defaults: {
                 id:      'audio',
                 url:     '',
@@ -438 +448 @@
 module.exports = AudioDetails;
 
 },{}],7:[function(require,module,exports){
+var Select = wp.media.view.MediaFrame.Select,
+        l10n = wp.media.view.l10n,
+        MediaDetails;
+
 /**
  * wp.media.view.MediaFrame.MediaDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -450 +466 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        l10n = wp.media.view.l10n,
-        MediaDetails;
-
-MediaDetails = Select.extend({
+MediaDetails = Select.extend(/** @lends wp.media.view.MediaFrame.MediaDetails.prototype */{
         defaults: {
                 id:      'media',
                 url:     '',
@@ -568 +580 @@
 module.exports = MediaDetails;
 
 },{}],8:[function(require,module,exports){
+var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
+        MediaLibrary = wp.media.controller.MediaLibrary,
+        l10n = wp.media.view.l10n,
+        VideoDetails;
+
 /**
  * wp.media.view.MediaFrame.VideoDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.MediaDetails
  * @augments wp.media.view.MediaFrame.Select
@@ -581 +600 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
-        MediaLibrary = wp.media.controller.MediaLibrary,
-        l10n = wp.media.view.l10n,
-        VideoDetails;
-
-VideoDetails = MediaDetails.extend({
+VideoDetails = MediaDetails.extend(/** @lends wp.media.view.MediaFrame.VideoDetails.prototype */{
         defaults: {
                 id:      'video',
                 url:     '',
@@ -704 +718 @@
 
 },{}],9:[function(require,module,exports){
 /* global MediaElementPlayer */
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        $ = jQuery,
+        MediaDetails;
 
 /**
  * wp.media.view.MediaDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -715 +734 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        $ = jQuery,
-        MediaDetails;
-
-MediaDetails = AttachmentDisplay.extend({
+MediaDetails = AttachmentDisplay.extend(/** @lends wp.media.view.MediaDetails.prototype */{
         initialize: function() {
                 _.bindAll(this, 'success');
                 this.players = [];
@@ -791 +806 @@
                 this.scriptXhr = false;
         },
 
-        /**
-         * @global MediaElementPlayer
-         */
         setPlayer : function() {
                 var src;
 
@@ -849 +861 @@
         resetFocus: function() {
                 this.$( '.embed-media-settings' ).scrollTop( 0 );
         }
-}, {
+},/** @lends wp.media.view.MediaDetails */{
         instances : 0,
         /**
          * When multiple players in the DOM contain the same src, things get weird.
@@ -875 +887 @@
 module.exports = MediaDetails;
 
 },{}],10:[function(require,module,exports){
+var MediaDetails = wp.media.view.MediaDetails,
+        VideoDetails;
+
 /**
  * wp.media.view.VideoDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MediaDetails
  * @augments wp.media.view.Settings.AttachmentDisplay
@@ -886 +903 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MediaDetails = wp.media.view.MediaDetails,
-        VideoDetails;
-
-VideoDetails = MediaDetails.extend({
+VideoDetails = MediaDetails.extend(/** @lends wp.media.view.VideoDetails.prototype */{
         className: 'video-details',
         template:  wp.template('video-details'),
 

src/wp-includes/js/media-editor.js

@@ -30 +30 @@
                 return attrs[ key ];
         };
 
-        /**
-         * wp.media.string
-         * @namespace
-         */
+        /** @namespace wp.media.string */
         wp.media.string = {
                 /**
                  * Joins the `props` and `attachment` objects,
                  * outputting the proper object format based on the
                  * attachment's type.
                  *
-                 * @global wp.media.view.settings
-                 * @global getUserSetting()
-                 *
                  * @param {Object} [props={}] Attachment details (align, link, size, etc).
                  * @param {Object} attachment The attachment object, media version of Post.
                  * @returns {Object} Joined props
@@ -109 +103 @@
                 /**
                  * Create link markup that is suitable for passing to the editor
                  *
-                 * @global wp.html.string
-                 *
                  * @param {Object} props Attachment details (align, link, size, etc).
                  * @param {Object} attachment The attachment object, media version of Post.
                  * @returns {string} The link markup
@@ -159 +151 @@
                  *
                  * @access private
                  *
-                 * @global wp.shortcode
-                 * @global wp.media.view.settings
-                 *
                  * @param {string} type The shortcode tag name: 'audio' or 'video'.
                  * @param {Object} props Attachment details (align, link, size, etc).
                  * @param {Object} attachment The attachment object, media version of Post.
@@ -210 +199 @@
                  * Create image markup, optionally with a link and/or wrapped in a caption shortcode,
                  *  that is suitable for passing to the editor
                  *
-                 * @global wp.html
-                 * @global wp.shortcode
-                 *
                  * @param {Object} props Attachment details (align, link, size, etc).
                  * @param {Object} attachment The attachment object, media version of Post.
                  * @returns {string}
@@ -341 +327 @@
                 }
         };
 
+        /**
+         * @class wp.media.collection
+         *
+         * @param {Object} attributes
+         */
         wp.media.collection = function(attributes) {
                 var collections = {};
 
-                return _.extend( {
+                return _.extend(/** @lends wp.media.collection.prototype */{
                         coerce : wp.media.coerce,
                         /**
                          * Retrieve attachments based on the properties of the passed shortcode
                          *
-                         * @global wp.media.query
-                         *
                          * @param {wp.shortcode} shortcode An instance of wp.shortcode().
                          * @returns {wp.media.model.Attachments} A Backbone.Collection containing
                          *      the media items belonging to a collection.
@@ -417 +406 @@
                         /**
                          * Triggered when clicking 'Insert {label}' or 'Update {label}'
                          *
-                         * @global wp.shortcode
-                         * @global wp.media.model.Attachments
-                         *
                          * @param {wp.media.model.Attachments} attachments A Backbone.Collection containing
                          *      the media items belonging to a collection.
                          *      The query[ this.tag ] property is a Backbone.Model
@@ -488 +474 @@
                          * Triggered when double-clicking a collection shortcode placeholder
                          *   in the editor
                          *
-                         * @global wp.shortcode
-                         * @global wp.media.model.Selection
-                         * @global wp.media.view.l10n
-                         *
                          * @param {string} content Content that is searched for possible
                          *    shortcode markup matching the passed tag name,
                          *
@@ -610 +592 @@
         });
 
         /**
-         * wp.media.featuredImage
-         * @namespace
+         * @namespace wp.media.featuredImage
+         * @memberOf wp.media
          */
         wp.media.featuredImage = {
                 /**
                  * Get the featured image post ID
                  *
-                 * @global wp.media.view.settings
-                 *
                  * @returns {wp.media.view.settings.post.featuredImageId|number}
                  */
                 get: function() {
@@ -628 +608 @@
                  * Set the featured image id, save the post thumbnail data and
                  * set the HTML in the post meta box to the new featured image.
                  *
-                 * @global wp.media.view.settings
-                 * @global wp.media.post
-                 *
                  * @param {number} id The post ID of the featured image, or -1 to unset it.
                  */
                 set: function( id ) {
@@ -660 +637 @@
                 /**
                  * The Featured Image workflow
                  *
-                 * @global wp.media.controller.FeaturedImage
-                 * @global wp.media.view.l10n
-                 *
                  * @this wp.media.featuredImage
                  *
                  * @returns {wp.media.view.MediaFrame.Select} A media workflow.
@@ -705 +679 @@
                  * 'select' callback for Featured Image workflow, triggered when
                  *  the 'Set Featured Image' button is clicked in the media modal.
                  *
-                 * @global wp.media.view.settings
-                 *
                  * @this wp.media.controller.FeaturedImage
                  */
                 select: function() {
@@ -723 +695 @@
                  * the post thumbnail is clicked.
                  *
                  * Update the featured image id when the 'remove' link is clicked.
-                 *
-                 * @global wp.media.view.settings
                  */
                 init: function() {
                         $('#postimagediv').on( 'click', '#set-post-thumbnail', function( event ) {
@@ -742 +712 @@
 
         $( wp.media.featuredImage.init );
 
-        /**
-         * wp.media.editor
-         * @namespace
-         */
+        /** @namespace wp.media.editor */
         wp.media.editor = {
                 /**
                  * Send content to the editor
                  *
-                 * @global tinymce
-                 * @global QTags
-                 * @global wpActiveEditor
-                 * @global tb_remove() - Possibly overloaded by legacy plugins
-                 *
                  * @param {string} html Content to send to the editor
                  */
                 insert: function( html ) {
@@ -805 +767 @@
                  * Setup 'workflow' and add to the 'workflows' cache. 'open' can
                  *  subsequently be called upon it.
                  *
-                 * @global wp.media.view.l10n
-                 *
                  * @param {string} id A slug used to identify the workflow.
                  * @param {Object} [options={}]
                  *
@@ -914 +874 @@
                 /**
                  * Determines the proper current workflow id
                  *
-                 * @global wpActiveEditor
-                 * @global tinymce
-                 *
                  * @param {string} [id=''] A slug used to identify the workflow.
                  *
                  * @returns {wpActiveEditor|string|tinymce.activeEditor.id}
@@ -962 +919 @@
                         id = this.id( id );
                         delete workflows[ id ];
                 },
-                /**
-                 * @namespace
-                 */
+                /** @namespace wp.media.editor.send */
                 send: {
                         /**
                          * Called when sending an attachment to the editor
                          *   from the medial modal.
                          *
-                         * @global wp.media.view.settings
-                         * @global wp.media.post
-                         *
                          * @param {Object} props Attachment details (align, link, size, etc).
                          * @param {Object} attachment The attachment object, media version of Post.
                          * @returns {Promise}
@@ -1028 +980 @@
                         /**
                          * Called when 'Insert From URL' source is not an image. Example: YouTube url.
                          *
-                         * @global wp.media.view.settings
-                         *
                          * @param {Object} embed
                          * @returns {Promise}
                          */
@@ -1075 +1025 @@
 
                 /**
                  * Bind click event for .insert-media using event delegation
-                 *
-                 * @global wp.media.view.l10n
                  */
                 init: function() {
                         $(document.body)

src/wp-includes/js/media-grid.js

@@ -1 +1 @@
 (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        EditAttachmentMetadata;
+
 /**
  * wp.media.controller.EditAttachmentMetadata
  *
  * A state for editing an attachment's metadata.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var l10n = wp.media.view.l10n,
-        EditAttachmentMetadata;
-
-EditAttachmentMetadata = wp.media.controller.State.extend({
+EditAttachmentMetadata = wp.media.controller.State.extend(/** @lends wp.media.controller.EditAttachmentMetadata.prototype */{
         defaults: {
                 id:      'edit-attachment',
                 // Title string passed to the frame's title region view.
@@ -45 +47 @@
  *
  * A router for handling the browser history and application state.
  *
+ * @memberOf wp.media.view.MediaFrame.Manage
+ *
  * @class
  * @augments Backbone.Router
  */
-var Router = Backbone.Router.extend({
+var Router = Backbone.Router.extend(/** @lends wp.media.view.MediaFrame.Manage.Router.prototype */{
         routes: {
                 'upload.php?item=:slug&mode=edit': 'editItem',
                 'upload.php?item=:slug':           'showItem',
@@ -107 +111 @@
 module.exports = Router;
 
 },{}],4:[function(require,module,exports){
+var Details = wp.media.view.Attachment.Details,
+        TwoColumn;
+
 /**
  * wp.media.view.Attachment.Details.TwoColumn
  *
  * A similar view to media.view.Attachment.Details
  * for use in the Edit Attachment modal.
  *
+ * @memberOf wp.media.view.Attachment.Details
+ *
  * @class
  * @augments wp.media.view.Attachment.Details
  * @augments wp.media.view.Attachment
@@ -120 +129 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Details = wp.media.view.Attachment.Details,
-        TwoColumn;
-
-TwoColumn = Details.extend({
+TwoColumn = Details.extend(/** @lends wp.media.view.Attachment.Details.TowColumn.prototype */{
         template: wp.template( 'attachment-details-two-column' ),
 
         initialize: function() {
@@ -158 +164 @@
 module.exports = TwoColumn;
 
 },{}],5:[function(require,module,exports){
+var Button = wp.media.view.Button,
+        DeleteSelected = wp.media.view.DeleteSelectedButton,
+        DeleteSelectedPermanently;
+
 /**
  * wp.media.view.DeleteSelectedPermanentlyButton
  *
  * When MEDIA_TRASH is true, a button that handles bulk Delete Permanently logic
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.DeleteSelectedButton
  * @augments wp.media.view.Button
@@ -170 +182 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        DeleteSelected = wp.media.view.DeleteSelectedButton,
-        DeleteSelectedPermanently;
-
-DeleteSelectedPermanently = DeleteSelected.extend({
+DeleteSelectedPermanently = DeleteSelected.extend(/** @lends wp.media.view.DeleteSelectedPermanentlyButton.prototype */{
         initialize: function() {
                 DeleteSelected.prototype.initialize.apply( this, arguments );
                 this.controller.on( 'select:activate', this.selectActivate, this );
@@ -205 +213 @@
 module.exports = DeleteSelectedPermanently;
 
 },{}],6:[function(require,module,exports){
+var Button = wp.media.view.Button,
+        l10n = wp.media.view.l10n,
+        DeleteSelected;
+
 /**
  * wp.media.view.DeleteSelectedButton
  *
  * A button that handles bulk Delete/Trash logic
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Button
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        l10n = wp.media.view.l10n,
-        DeleteSelected;
-
-DeleteSelected = Button.extend({
+DeleteSelected = Button.extend(/** @lends wp.media.view.DeleteSelectedButton.prototype */{
         initialize: function() {
                 Button.prototype.initialize.apply( this, arguments );
                 if ( this.options.filters ) {
@@ -258 +268 @@
 module.exports = DeleteSelected;
 
 },{}],7:[function(require,module,exports){
+
+var Button = wp.media.view.Button,
+        l10n = wp.media.view.l10n,
+        SelectModeToggle;
+
 /**
  * wp.media.view.SelectModeToggleButton
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Button
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        l10n = wp.media.view.l10n,
-        SelectModeToggle;
-
-SelectModeToggle = Button.extend({
+SelectModeToggle = Button.extend(/** @lends wp.media.view.SelectModeToggle.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         size : ''
@@ -332 +345 @@
 module.exports = SelectModeToggle;
 
 },{}],8:[function(require,module,exports){
+var View = wp.media.View,
+        EditImage = wp.media.view.EditImage,
+        Details;
+
 /**
  * wp.media.view.EditImage.Details
  *
+ * @memberOf wp.media.view.EditImage
+ *
  * @class
  * @augments wp.media.view.EditImage
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        EditImage = wp.media.view.EditImage,
-        Details;
-
-Details = EditImage.extend({
+Details = EditImage.extend(/** @lends wp.media.view.EditImage.Details.prototype */{
         initialize: function( options ) {
                 this.editor = window.imageEdit;
                 this.frame = options.frame;
@@ -367 +382 @@
 module.exports = Details;
 
 },{}],9:[function(require,module,exports){
+var Frame = wp.media.view.Frame,
+        MediaFrame = wp.media.view.MediaFrame,
+
+        $ = jQuery,
+        EditAttachments;
+
 /**
  * wp.media.view.MediaFrame.EditAttachments
  *
@@ -376 +397 @@
  *
  * Requires an attachment model to be passed in the options hash under `model`.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.Frame
  * @augments wp.media.View
@@ -383 +406 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.view.Frame,
-        MediaFrame = wp.media.view.MediaFrame,
-
-        $ = jQuery,
-        EditAttachments;
-
-EditAttachments = MediaFrame.extend({
+EditAttachments = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.EditAttachments.prototype */{
 
         className: 'edit-attachment-frame',
         template:  wp.template( 'edit-attachment-frame' ),
@@ -627 +644 @@
 module.exports = EditAttachments;
 
 },{}],10:[function(require,module,exports){
+var MediaFrame = wp.media.view.MediaFrame,
+        Library = wp.media.controller.Library,
+
+        $ = Backbone.$,
+        Manage;
+
 /**
  * wp.media.view.MediaFrame.Manage
  *
@@ -634 +657 @@
  *
  * Used in the media grid view.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame
  * @augments wp.media.view.Frame
@@ -642 +667 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaFrame = wp.media.view.MediaFrame,
-        Library = wp.media.controller.Library,
-
-        $ = Backbone.$,
-        Manage;
-
-Manage = MediaFrame.extend({
+Manage = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Manage.prototype */{
         /**
-         * @global wp.Uploader
+         * @constructs
          */
         initialize: function() {
                 _.defaults( this.options, {

src/wp-includes/js/media-models.js

@@ -2 +2 @@
 var $ = jQuery,
         Attachment, Attachments, l10n, media;
 
+/** @namespace wp */
 window.wp = window.wp || {};
 
 /**
@@ -9 +10 @@
  *
  * Handles the default media experience.
  *
+ * @alias wp.media
+ * @memberOf wp
+ *
  * @param  {object} attributes The properties passed to the main media controller.
  * @return {wp.media.view.MediaFrame} A media workflow.
  */
@@ -47 +51 @@
         return frame;
 };
 
+/** @namespace wp.media */
+/** @namespace wp.media.model */
+/** @namespace wp.media.view */
+/** @namespace wp.media.controller */
+/** @namespace wp.media.frames */
 _.extend( media, { model: {}, view: {}, controller: {}, frames: {} });
 
 // Link any localized strings.
@@ -90 +99 @@
         }
 };
 
-_.extend( media, {
+_.extend( media, /** @lends wp.media */{
         /**
          * media.template( id )
          *
@@ -230 +239 @@
 });
 
 },{"./models/attachment.js":2,"./models/attachments.js":3,"./models/post-image.js":4,"./models/query.js":5,"./models/selection.js":6}],2:[function(require,module,exports){
+var $ = Backbone.$,
+        Attachment;
+
 /**
  * wp.media.model.Attachment
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  */
-var $ = Backbone.$,
-        Attachment;
-
-Attachment = Backbone.Model.extend({
+Attachment = Backbone.Model.extend(/** @lends wp.media.model.Attachment.prototype */{
         /**
          * Triggered when attachment details change
          * Overrides Backbone.Model.sync
@@ -366 +377 @@
                         model.set( model.parse( resp, xhr ), options );
                 });
         }
-}, {
+},/** @lends wp.media.model.Attachment */{
         /**
          * Create a new model on the static 'all' attachments collection and return it.
          *
          * @static
+         *
          * @param {Object} attrs
          * @returns {wp.media.model.Attachment}
          */
@@ -407 +419 @@
  * 'options.props.query = true', which will mirror the collection
  * to an Attachments Query collection - @see wp.media.model.Attachments.mirror().
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Collection
  *
@@ -420 +434 @@
  * @param {string} [options.filters]
  *
  */
-var Attachments = Backbone.Collection.extend({
+var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachments.prototype */{
         /**
          * @type {wp.media.model.Attachment}
          */
@@ -818 +832 @@
                         attachments: attachments
                 });
         }
-}, {
+},/** @lends wp.media.model.Attachments */{
         /**
          * A function to compare two attachment models in an attachments collection.
          *
          * Used as the default comparator for instances of wp.media.model.Attachments
          * and its subclasses. @see wp.media.model.Attachments._changeOrderby().
          *
-         * @static
-         *
          * @param {Backbone.Model} a
          * @param {Backbone.Model} b
          * @param {Object} options
@@ -855 +867 @@
 
                 return ( 'DESC' === order ) ? wp.media.compare( a, b, ac, bc ) : wp.media.compare( b, a, bc, ac );
         },
-        /**
-         * @namespace
-         */
+        /** @namespace wp.media.model.Attachments.filters */
         filters: {
                 /**
                  * @static
@@ -952 +962 @@
  *
  * Used in the embedded image attachment display settings modal - @see wp.media.view.MediaFrame.ImageDetails.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  *
  * @param {int} [attributes]               Initial model attributes.
  * @param {int} [attributes.attachment_id] ID of the attachment.
  **/
-var PostImage = Backbone.Model.extend({
+var PostImage = Backbone.Model.extend(/** @lends wp.media.model.PostImage.prototype */{
 
         initialize: function( attributes ) {
                 var Attachment = wp.media.model.Attachment;
@@ -1099 +1111 @@
 module.exports = PostImage;
 
 },{}],5:[function(require,module,exports){
+var Attachments = wp.media.model.Attachments,
+        Query;
+
 /**
  * wp.media.model.Query
  *
@@ -1107 +1122 @@
  * Note: Do NOT change this.args after the query has been initialized.
  *       Things will break.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments wp.media.model.Attachments
  * @augments Backbone.Collection
@@ -1116 +1133 @@
  * @param {object} [options.args]                Attachments query arguments.
  * @param {object} [options.args.posts_per_page]
  */
-var Attachments = wp.media.model.Attachments,
-        Query;
-
-Query = Attachments.extend({
+Query = Attachments.extend(/** @lends wp.media.model.Query.prototype */{
         /**
-         * @global wp.Uploader
-         *
          * @param {array}  [models=[]]  Array of initial models to populate the collection.
          * @param {object} [options={}]
          */
@@ -1254 +1266 @@
                         return fallback.sync.apply( this, arguments );
                 }
         }
-}, {
+}, /** @lends wp.media.model.Query */{
         /**
          * @readonly
          */
@@ -1407 +1419 @@
 module.exports = Query;
 
 },{}],6:[function(require,module,exports){
+var Attachments = wp.media.model.Attachments,
+        Selection;
+
 /**
  * wp.media.model.Selection
  *
  * A selection of attachments.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments wp.media.model.Attachments
  * @augments Backbone.Collection
  */
-var Attachments = wp.media.model.Attachments,
-        Selection;
-
-Selection = Attachments.extend({
+Selection = Attachments.extend(/** @lends wp.media.model.Selection.prototype */{
         /**
          * Refresh the `single` model whenever the selection changes.
          * Binds `single` instead of using the context argument to ensure

src/wp-includes/js/media-views.js

@@ -1 +1 @@
 (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+var Selection = wp.media.model.Selection,
+        Library = wp.media.controller.Library,
+        CollectionAdd;
+
 /**
  * wp.media.controller.CollectionAdd
  *
  * A state for adding attachments to a collection (e.g. video playlist).
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -32 +38 @@
  * @param {string}                     attributes.type                   The collection's media type. (e.g. 'video').
  * @param {string}                     attributes.collectionType         The collection type. (e.g. 'playlist').
  */
-var Selection = wp.media.model.Selection,
-        Library = wp.media.controller.Library,
-        CollectionAdd;
-
-CollectionAdd = Library.extend({
+CollectionAdd = Library.extend(/** @lends wp.media.controller.CollectionAdd.prototype */{
         defaults: _.defaults( {
                 // Selection defaults. @see media.model.Selection
                 multiple:      'add',
@@ -100 +102 @@
 module.exports = CollectionAdd;
 
 },{}],2:[function(require,module,exports){
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        CollectionEdit;
+
 /**
  * wp.media.controller.CollectionEdit
  *
  * A state for editing a collection, which is used by audio and video playlists,
  * and can be used for other collections.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -135 +144 @@
  * @param {string}                     attributes.type                   The collection's media type. (e.g. 'video').
  * @param {string}                     attributes.collectionType         The collection type. (e.g. 'playlist').
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        CollectionEdit;
-
-CollectionEdit = Library.extend({
+CollectionEdit = Library.extend(/** @lends wp.media.controller.CollectionEdit.prototype */{
         defaults: {
                 multiple:         false,
                 sortable:         true,
@@ -262 +266 @@
 module.exports = CollectionEdit;
 
 },{}],3:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        Cropper;
+
 /**
  * wp.media.controller.Cropper
  *
  * A state for cropping an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var l10n = wp.media.view.l10n,
-        Cropper;
-
-Cropper = wp.media.controller.State.extend({
+Cropper = wp.media.controller.State.extend(/** @lends wp.media.controller.Cropper.prototype */{
         defaults: {
                 id:          'cropper',
                 title:       l10n.cropImage,
@@ -384 +390 @@
 module.exports = Cropper;
 
 },{}],4:[function(require,module,exports){
+var Controller = wp.media.controller,
+        CustomizeImageCropper;
+
 /**
  * wp.media.controller.CustomizeImageCropper
  *
+ * @memberOf wp.media.controller
+ *
  * A state for cropping an image.
  *
  * @class
@@ -394 +405 @@
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var Controller = wp.media.controller,
-        CustomizeImageCropper;
-
-CustomizeImageCropper = Controller.Cropper.extend({
+CustomizeImageCropper = Controller.Cropper.extend(/** @lends wp.media.controller.CustomizeImageCropper.prototype */{
         doCrop: function( attachment ) {
                 var cropDetails = attachment.get( 'cropDetails' ),
                         control = this.get( 'control' ),
@@ -427 +435 @@
 module.exports = CustomizeImageCropper;
 
 },{}],5:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        EditImage;
+
 /**
  * wp.media.controller.EditImage
  *
  * A state for editing (cropping, etc.) an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -445 +458 @@
  * @param {string}                    [attributes.menu=false]         Initial mode for the menu region.
  * @param {string}                    [attributes.url]                Unused. @todo Consider removal.
  */
-var l10n = wp.media.view.l10n,
-        EditImage;
-
-EditImage = wp.media.controller.State.extend({
+EditImage = wp.media.controller.State.extend(/** @lends wp.media.controller.EditImage.prototype */{
         defaults: {
                 id:      'edit-image',
                 title:   l10n.editImage,
@@ -503 +513 @@
 module.exports = EditImage;
 
 },{}],6:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        $ = Backbone.$,
+        Embed;
+
 /**
  * wp.media.controller.Embed
  *
  * A state for embedding media from a URL.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -524 +540 @@
  * @param {string} [attributes.url]                   The embed URL.
  * @param {object} [attributes.metadata={}]           Properties of the embed, which will override attributes.url if set.
  */
-var l10n = wp.media.view.l10n,
-        $ = Backbone.$,
-        Embed;
-
-Embed = wp.media.controller.State.extend({
+Embed = wp.media.controller.State.extend(/** @lends wp.media.controller.Embed.prototype */{
         defaults: {
                 id:       'embed',
                 title:    l10n.insertFromUrlTitle,
@@ -639 +651 @@
 module.exports = Embed;
 
 },{}],7:[function(require,module,exports){
+var Attachment = wp.media.model.Attachment,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        FeaturedImage;
+
 /**
  * wp.media.controller.FeaturedImage
  *
  * A state for selecting a featured image for a post.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -670 +689 @@
  * @param {boolean}                    [attributes.contentUserSetting=true]  Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                    [attributes.syncSelection=true]       Whether the Attachments selection should be persisted from the last state.
  */
-var Attachment = wp.media.model.Attachment,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        FeaturedImage;
-
-FeaturedImage = Library.extend({
+FeaturedImage = Library.extend(/** @lends wp.media.controller.FeaturedImage.prototype */{
         defaults: _.defaults({
                 id:            'featured-image',
                 title:         l10n.setFeaturedImageTitle,
@@ -761 +775 @@
 module.exports = FeaturedImage;
 
 },{}],8:[function(require,module,exports){
+var Selection = wp.media.model.Selection,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        GalleryAdd;
+
 /**
  * wp.media.controller.GalleryAdd
  *
  * A state for selecting more images to add to a gallery.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -792 +813 @@
  * @param {boolean}                    [attributes.syncSelection=false]     Whether the Attachments selection should be persisted from the last state.
  *                                                                          Defaults to false because for this state, because the library of the Edit Gallery state is the selection.
  */
-var Selection = wp.media.model.Selection,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        GalleryAdd;
-
-GalleryAdd = Library.extend({
+GalleryAdd = Library.extend(/** @lends wp.media.controller.GalleryAdd.prototype */{
         defaults: _.defaults({
                 id:            'gallery-library',
                 title:         l10n.addToGalleryTitle,
@@ -852 +868 @@
 module.exports = GalleryAdd;
 
 },{}],9:[function(require,module,exports){
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        GalleryEdit;
+
 /**
  * wp.media.controller.GalleryEdit
  *
  * A state for editing a gallery's images and settings.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -884 +906 @@
  * @param {view}                       [attributes.AttachmentView]        The single `Attachment` view to be used in the `Attachments`.
  *                                                                        If none supplied, defaults to wp.media.view.Attachment.EditLibrary.
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        GalleryEdit;
-
-GalleryEdit = Library.extend({
+GalleryEdit = Library.extend(/** @lends wp.media.controller.GalleryEdit.prototype */{
         defaults: {
                 id:               'gallery-edit',
                 title:            l10n.editGalleryTitle,
@@ -994 +1012 @@
 module.exports = GalleryEdit;
 
 },{}],10:[function(require,module,exports){
+var State = wp.media.controller.State,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        ImageDetails;
+
 /**
  * wp.media.controller.ImageDetails
  *
  * A state for editing the attachment display settings of an image that's been
  * inserted into the editor.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -1018 +1043 @@
  * @todo This state inherits some defaults from media.controller.Library.prototype.defaults,
  *       however this may not do anything.
  */
-var State = wp.media.controller.State,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        ImageDetails;
-
-ImageDetails = State.extend({
+ImageDetails = State.extend(/** @lends wp.media.controller.ImageDetails.prototype */{
         defaults: _.defaults({
                 id:       'image-details',
                 title:    l10n.imageDetailsTitle,
@@ -1056 +1076 @@
 module.exports = ImageDetails;
 
 },{}],11:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        getUserSetting = window.getUserSetting,
+        setUserSetting = window.setUserSetting,
+        Library;
+
 /**
  * wp.media.controller.Library
  *
  * A state for choosing an attachment or group of attachments from the media library.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -1090 +1117 @@
  * @param {boolean}                         [attributes.contentUserSetting=true] Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                         [attributes.syncSelection=true]      Whether the Attachments selection should be persisted from the last state.
  */
-var l10n = wp.media.view.l10n,
-        getUserSetting = window.getUserSetting,
-        setUserSetting = window.setUserSetting,
-        Library;
-
-Library = wp.media.controller.State.extend({
+Library = wp.media.controller.State.extend(/** @lends wp.media.controller.Library.prototype */{
         defaults: {
                 id:                 'library',
                 title:              l10n.mediaLibraryTitle,
@@ -1352 +1374 @@
 /**
  * wp.media.controller.MediaLibrary
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -1360 +1384 @@
 var Library = wp.media.controller.Library,
         MediaLibrary;
 
-MediaLibrary = Library.extend({
+MediaLibrary = Library.extend(/** @lends wp.media.controller.MediaLibrary.prototype */{
         defaults: _.defaults({
                 // Attachments browser defaults. @see media.view.AttachmentsBrowser
                 filterable:      'uploaded',
@@ -1412 +1436 @@
  * 'browse' mode t be activated on the 'content' view and then fills the region
  * with an AttachmentsBrowser view.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  *
  * @param {object}        options          Options hash for the region.
@@ -1426 +1452 @@
 // Use Backbone's self-propagating `extend` inheritance method.
 Region.extend = Backbone.Model.extend;
 
-_.extend( Region.prototype, {
+_.extend( Region.prototype,/** @lends wp.media.controller.Region.prototype */{
         /**
          * Activate a mode.
          *
@@ -1434 +1460 @@
          *
          * @param {string} mode
          *
-         * @fires this.view#{this.id}:activate:{this._mode}
-         * @fires this.view#{this.id}:activate
-         * @fires this.view#{this.id}:deactivate:{this._mode}
-         * @fires this.view#{this.id}:deactivate
+         * @fires Region#activate
+         * @fires Region#deactivate
          *
          * @returns {wp.media.controller.Region} Returns itself to allow chaining.
          */
@@ -1453 +1477 @@
                 /**
                  * Region mode deactivation event.
                  *
-                 * @event this.view#{this.id}:deactivate:{this._mode}
-                 * @event this.view#{this.id}:deactivate
+                 * @event wp.media.controller.Region#deactivate
                  */
                 this.trigger('deactivate');
 
@@ -1464 +1487 @@
                 /**
                  * Region mode activation event.
                  *
-                 * @event this.view#{this.id}:activate:{this._mode}
-                 * @event this.view#{this.id}:activate
+                 * @event wp.media.controller.Region#activate
                  */
                 this.trigger('activate');
                 return this;
@@ -1477 +1499 @@
          *
          * @param {string} mode
          *
-         * @fires this.view#{this.id}:create:{this._mode}
-         * @fires this.view#{this.id}:create
-         * @fires this.view#{this.id}:render:{this._mode}
-         * @fires this.view#{this.id}:render
+         * @fires Region#create
+         * @fires Region#render
          *
          * @returns {wp.media.controller.Region} Returns itself to allow chaining
          */
@@ -1498 +1518 @@
                  *
                  * Region view creation takes place in an event callback on the frame.
                  *
-                 * @event this.view#{this.id}:create:{this._mode}
-                 * @event this.view#{this.id}:create
+                 * @event wp.media.controller.Region#create
+                 * @type {object}
+                 * @property {object} view
                  */
                 this.trigger( 'create', set );
                 view = set.view;
@@ -1509 +1530 @@
                  *
                  * Region view creation takes place in an event callback on the frame.
                  *
-                 * @event this.view#{this.id}:create:{this._mode}
-                 * @event this.view#{this.id}:create
+                 * @event wp.media.controller.Region#render
+                 * @type {object}
                  */
                 this.trigger( 'render', view );
                 if ( view ) {
@@ -1578 +1599 @@
 module.exports = Region;
 
 },{}],14:[function(require,module,exports){
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        ReplaceImage;
+
 /**
  * wp.media.controller.ReplaceImage
  *
  * A state for replacing an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -1609 +1636 @@
  * @param {boolean}                    [attributes.contentUserSetting=true] Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                    [attributes.syncSelection=true]      Whether the Attachments selection should be persisted from the last state.
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        ReplaceImage;
-
-ReplaceImage = Library.extend({
+ReplaceImage = Library.extend(/** @lends wp.media.controller.ReplaceImage.prototype */{
         defaults: _.defaults({
                 id:            'replace-image',
                 title:         l10n.replaceImageTitle,
@@ -1686 +1709 @@
 module.exports = ReplaceImage;
 
 },{}],15:[function(require,module,exports){
+var Controller = wp.media.controller,
+        SiteIconCropper;
+
 /**
  * wp.media.controller.SiteIconCropper
  *
  * A state for cropping a Site Icon.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Cropper
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var Controller = wp.media.controller,
-        SiteIconCropper;
-
-SiteIconCropper = Controller.Cropper.extend({
+SiteIconCropper = Controller.Cropper.extend(/** @lends wp.media.controller.SiteIconCropper.prototype */{
         activate: function() {
                 this.frame.on( 'content:create:crop', this.createCropContent, this );
                 this.frame.on( 'close', this.removeCropper, this );
@@ -1743 +1768 @@
  *
  * States are stored as models in a Backbone collection.
  *
+ * @memberOf wp.media.controller
+ *
  * @since 3.5.0
  *
  * @class
@@ -1760 +1787 @@
 // Use Backbone's self-propagating `extend` inheritance method.
 StateMachine.extend = Backbone.Model.extend;
 
-_.extend( StateMachine.prototype, Backbone.Events, {
+_.extend( StateMachine.prototype, Backbone.Events,/** @lends wp.media.controller.StateMachine.prototype */{
         /**
          * Fetch a state.
          *
@@ -1844 +1871 @@
 // Map all event binding and triggering on a StateMachine to its `states` collection.
 _.each([ 'on', 'off', 'trigger' ], function( method ) {
         /**
+         * @function on
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
+         */
+        /**
+         * @function off
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
+         */
+        /**
+         * @function trigger
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
          */
         StateMachine.prototype[ method ] = function() {
@@ -1873 +1915 @@
  *     'reset'      is not triggered automatically. It should be invoked by the
  *                  proper controller to reset the state to its default.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments Backbone.Model
  */
-var State = Backbone.Model.extend({
+var State = Backbone.Model.extend(/** @lends wp.media.controller.State.prototype */{
         /**
          * Constructor.
          *
@@ -2108 +2152 @@
  * Allows for selecting multiple images in the Insert Media workflow, and then
  * switching to the Insert Gallery workflow while preserving the attachments selection.
  *
+ * @memberOf wp.media
+ *
  * @mixin
  */
 var selectionSync = {
@@ -2317 +2363 @@
 media.view.Spinner = require( './views/spinner.js' );
 
 },{"./controllers/collection-add.js":1,"./controllers/collection-edit.js":2,"./controllers/cropper.js":3,"./controllers/customize-image-cropper.js":4,"./controllers/edit-image.js":5,"./controllers/embed.js":6,"./controllers/featured-image.js":7,"./controllers/gallery-add.js":8,"./controllers/gallery-edit.js":9,"./controllers/image-details.js":10,"./controllers/library.js":11,"./controllers/media-library.js":12,"./controllers/region.js":13,"./controllers/replace-image.js":14,"./controllers/site-icon-cropper.js":15,"./controllers/state-machine.js":16,"./controllers/state.js":17,"./utils/selection-sync.js":18,"./views/attachment-compat.js":20,"./views/attachment-filters.js":21,"./views/attachment-filters/all.js":22,"./views/attachment-filters/date.js":23,"./views/attachment-filters/uploaded.js":24,"./views/attachment.js":25,"./views/attachment/details.js":26,"./views/attachment/edit-library.js":27,"./views/attachment/edit-selection.js":28,"./views/attachment/library.js":29,"./views/attachment/selection.js":30,"./views/attachments.js":31,"./views/attachments/browser.js":32,"./views/attachments/selection.js":33,"./views/button-group.js":34,"./views/button.js":35,"./views/cropper.js":36,"./views/edit-image.js":37,"./views/embed.js":38,"./views/embed/image.js":39,"./views/embed/link.js":40,"./views/embed/url.js":41,"./views/focus-manager.js":42,"./views/frame.js":43,"./views/frame/image-details.js":44,"./views/frame/post.js":45,"./views/frame/select.js":46,"./views/iframe.js":47,"./views/image-details.js":48,"./views/label.js":49,"./views/media-frame.js":50,"./views/menu-item.js":51,"./views/menu.js":52,"./views/modal.js":53,"./views/priority-list.js":54,"./views/router-item.js":55,"./views/router.js":56,"./views/search.js":57,"./views/selection.js":58,"./views/settings.js":59,"./views/settings/attachment-display.js":60,"./views/settings/gallery.js":61,"./views/settings/playlist.js":62,"./views/sidebar.js":63,"./views/site-icon-cropper.js":64,"./views/site-icon-preview.js":65,"./views/spinner.js":66,"./views/toolbar.js":67,"./views/toolbar/embed.js":68,"./views/toolbar/select.js":69,"./views/uploader/editor.js":70,"./views/uploader/inline.js":71,"./views/uploader/status-error.js":72,"./views/uploader/status.js":73,"./views/uploader/window.js":74,"./views/view.js":75}],20:[function(require,module,exports){
+var View = wp.media.View,
+        AttachmentCompat;
+
 /**
  * wp.media.view.AttachmentCompat
  *
  * A view to display fields added via the `attachment_fields_to_edit` filter.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        AttachmentCompat;
-
-AttachmentCompat = View.extend({
+AttachmentCompat = View.extend(/** @lends wp.media.view.AttachmentCompat.prototype */{
         tagName:   'form',
         className: 'compat-item',
 
@@ -2402 +2450 @@
 module.exports = AttachmentCompat;
 
 },{}],21:[function(require,module,exports){
+var $ = jQuery,
+        AttachmentFilters;
+
 /**
  * wp.media.view.AttachmentFilters
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        AttachmentFilters;
-
-AttachmentFilters = wp.media.View.extend({
+AttachmentFilters = wp.media.View.extend(/** @lends wp.media.view.AttachmentFilters.prototype */{
         tagName:   'select',
         className: 'attachment-filters',
         id:        'media-attachment-filters',
@@ -2479 +2529 @@
 module.exports = AttachmentFilters;
 
 },{}],22:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        All;
+
 /**
  * wp.media.view.AttachmentFilters.All
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        All;
-
-All = wp.media.view.AttachmentFilters.extend({
+All = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.All.prototype */{
         createFilters: function() {
                 var filters = {};
 
@@ -2569 +2621 @@
 module.exports = All;
 
 },{}],23:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        DateFilter;
+
 /**
  * A filter dropdown for month/dates.
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        DateFilter;
-
-DateFilter = wp.media.view.AttachmentFilters.extend({
+DateFilter = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.Date.prototype */{
         id: 'media-attachment-date-filters',
 
         createFilters: function() {
@@ -2610 +2664 @@
 module.exports = DateFilter;
 
 },{}],24:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        Uploaded;
+
 /**
  * wp.media.view.AttachmentFilters.Uploaded
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Uploaded;
-
-Uploaded = wp.media.view.AttachmentFilters.extend({
+Uploaded = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.Uploaded.prototype */{
         createFilters: function() {
                 var type = this.model.get('type'),
                         types = wp.media.view.settings.mimeTypes,
@@ -2669 +2725 @@
 module.exports = Uploaded;
 
 },{}],25:[function(require,module,exports){
+var View = wp.media.View,
+        $ = jQuery,
+        Attachment;
+
 /**
  * wp.media.view.Attachment
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        Attachment;
-
-Attachment = View.extend({
+Attachment = View.extend(/** @lends wp.media.view.Attachment.prototype */{
         tagName:   'li',
         className: 'attachment',
         template:  wp.template('attachment'),
@@ -3189 +3247 @@
         album:   '_syncAlbum'
 }, function( method, setting ) {
         /**
+         * @function _syncCaption
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncTitle
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncArtist
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncAlbum
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
          * @param {Backbone.Model} model
          * @param {string} value
          * @returns {wp.media.view.Attachment} Returns itself to allow chaining
@@ -3215 +3304 @@
 module.exports = Attachment;
 
 },{}],26:[function(require,module,exports){
+var Attachment = wp.media.view.Attachment,
+        l10n = wp.media.view.l10n,
+        Details;
+
 /**
  * wp.media.view.Attachment.Details
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Attachment = wp.media.view.Attachment,
-        l10n = wp.media.view.l10n,
-        Details;
-
-Details = Attachment.extend({
+Details = Attachment.extend(/** @lends wp.media.view.Attachment.Details.prototype */{
         tagName:   'div',
         className: 'attachment-details',
         template:  wp.template('attachment-details'),
@@ -3356 +3447 @@
 /**
  * wp.media.view.Attachment.EditLibrary
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var EditLibrary = wp.media.view.Attachment.extend({
+var EditLibrary = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.EditLibrary.prototype */{
         buttons: {
                 close: true
         }
@@ -3372 +3465 @@
 
 },{}],28:[function(require,module,exports){
 /**
- * wp.media.view.Attachments.EditSelection
+ * wp.media.view.Attachment.EditSelection
+ *
+ * @memberOf wp.media.view.Attachment
  *
  * @class
  * @augments wp.media.view.Attachment.Selection
@@ -3381 +3476 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var EditSelection = wp.media.view.Attachment.Selection.extend({
+var EditSelection = wp.media.view.Attachment.Selection.extend(/** @lends wp.media.view.Attachment.EditSelection.prototype */{
         buttons: {
                 close: true
         }
@@ -3393 +3488 @@
 /**
  * wp.media.view.Attachment.Library
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Library = wp.media.view.Attachment.extend({
+var Library = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.Library.prototype */{
         buttons: {
                 check: true
         }
@@ -3411 +3508 @@
 /**
  * wp.media.view.Attachment.Selection
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Selection = wp.media.view.Attachment.extend({
+var Selection = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.Selection.prototype */{
         className: 'attachment selection',
 
         // On click, just select the model, instead of removing the model from
@@ -3430 +3529 @@
 module.exports = Selection;
 
 },{}],31:[function(require,module,exports){
+var View = wp.media.View,
+        $ = jQuery,
+        Attachments;
+
 /**
  * wp.media.view.Attachments
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        Attachments;
-
-Attachments = View.extend({
+Attachments = View.extend(/** @lends wp.media.view.Attachments.prototype */{
         tagName:   'ul',
         className: 'attachments',
 
@@ -3729 +3830 @@
 module.exports = Attachments;
 
 },{}],32:[function(require,module,exports){
+var View = wp.media.View,
+        mediaTrash = wp.media.view.settings.mediaTrash,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        AttachmentsBrowser;
+
 /**
  * wp.media.view.AttachmentsBrowser
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
@@ -3749 +3858 @@
  * @param {boolean|string} [options.sidebar=true]  Whether to create a sidebar for the browser.
  *                                                 Accepts true, false, and 'errors'.
  */
-var View = wp.media.View,
-        mediaTrash = wp.media.view.settings.mediaTrash,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        AttachmentsBrowser;
-
-AttachmentsBrowser = View.extend({
+AttachmentsBrowser = View.extend(/** @lends wp.media.view.AttachmentsBrowser.prototype */{
         tagName:   'div',
         className: 'attachments-browser',
 
@@ -4205 +4308 @@
 module.exports = AttachmentsBrowser;
 
 },{}],33:[function(require,module,exports){
+var Attachments = wp.media.view.Attachments,
+        Selection;
+
 /**
  * wp.media.view.Attachments.Selection
  *
+ * @memberOf wp.media.view.Attachments
+ *
  * @class
  * @augments wp.media.view.Attachments
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Attachments = wp.media.view.Attachments,
-        Selection;
-
-Selection = Attachments.extend({
+Selection = Attachments.extend(/** @lends wp.media.view.Attachments.Selection.prototype */{
         events: {},
         initialize: function() {
                 _.defaults( this.options, {
@@ -4235 +4340 @@
 module.exports = Selection;
 
 },{}],34:[function(require,module,exports){
+var $ = Backbone.$,
+        ButtonGroup;
+
 /**
  * wp.media.view.ButtonGroup
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = Backbone.$,
-        ButtonGroup;
-
-ButtonGroup = wp.media.View.extend({
+ButtonGroup = wp.media.View.extend(/** @lends wp.media.view.ButtonGroup.prototype */{
         tagName:   'div',
         className: 'button-group button-large media-button-group',
 
@@ -4284 +4391 @@
 /**
  * wp.media.view.Button
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.View.extend({
+var Button = wp.media.View.extend(/** @lends wp.media.view.Button.prototype */{
         tagName:    'button',
         className:  'media-button',
         attributes: { type: 'button' },
@@ -4367 +4476 @@
 module.exports = Button;
 
 },{}],36:[function(require,module,exports){
+var View = wp.media.View,
+        UploaderStatus = wp.media.view.UploaderStatus,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        Cropper;
+
 /**
  * wp.media.view.Cropper
  *
@@ -4376 +4491 @@
  * wp.customize.HeaderControl.calculateImageSelectOptions via
  * wp.customize.HeaderControl.openMM.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderStatus = wp.media.view.UploaderStatus,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        Cropper;
-
-Cropper = View.extend({
+Cropper = View.extend(/** @lends wp.media.view.Cropper.prototype */{
         className: 'crop-content',
         template: wp.template('crop-content'),
         initialize: function() {
@@ -4434 +4545 @@
 module.exports = Cropper;
 
 },{}],37:[function(require,module,exports){
+var View = wp.media.View,
+        EditImage;
+
 /**
  * wp.media.view.EditImage
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        EditImage;
-
-EditImage = View.extend({
+EditImage = View.extend(/** @lends wp.media.view.EditImage.prototype */{
         className: 'image-editor',
         template: wp.template('image-editor'),
 
@@ -4493 +4606 @@
 /**
  * wp.media.view.Embed
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Embed = wp.media.View.extend({
+var Embed = wp.media.View.extend(/** @lends wp.media.view.Ember.prototype */{
         className: 'media-embed',
 
         initialize: function() {
@@ -4554 +4669 @@
 module.exports = Embed;
 
 },{}],39:[function(require,module,exports){
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        EmbedImage;
+
 /**
  * wp.media.view.EmbedImage
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -4564 +4684 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        EmbedImage;
-
-EmbedImage = AttachmentDisplay.extend({
+EmbedImage = AttachmentDisplay.extend(/** @lends wp.media.view.EmbedImage.prototype */{
         className: 'embed-media-settings',
         template:  wp.template('embed-image-settings'),
 
@@ -4587 +4704 @@
 module.exports = EmbedImage;
 
 },{}],40:[function(require,module,exports){
+var $ = jQuery,
+        EmbedLink;
+
 /**
  * wp.media.view.EmbedLink
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        EmbedLink;
-
-EmbedLink = wp.media.view.Settings.extend({
+EmbedLink = wp.media.view.Settings.extend(/** @lends wp.media.view.EmbedLink.prototype */{
         className: 'embed-link-settings',
         template:  wp.template('embed-link-settings'),
 
@@ -4684 +4803 @@
 module.exports = EmbedLink;
 
 },{}],41:[function(require,module,exports){
+var View = wp.media.View,
+        $ = jQuery,
+        EmbedUrl;
+
 /**
  * wp.media.view.EmbedUrl
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        EmbedUrl;
-
-EmbedUrl = View.extend({
+EmbedUrl = View.extend(/** @lends wp.media.view.EmbedUrl.prototype */{
         tagName:   'label',
         className: 'embed-url',
 
@@ -4766 +4887 @@
 /**
  * wp.media.view.FocusManager
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var FocusManager = wp.media.View.extend({
+var FocusManager = wp.media.View.extend(/** @lends wp.media.view.FocusManager.prototype */{
 
         events: {
                 'keydown': 'constrainTabbing'
@@ -4815 +4938 @@
  * A frame is a composite view consisting of one or more regions and one or more
  * states.
  *
+ * @memberOf wp.media.view
+ *
  * @see wp.media.controller.State
  * @see wp.media.controller.Region
  *
@@ -4824 +4949 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.View.extend({
+var Frame = wp.media.View.extend(/** @lends wp.media.view.Frame.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         mode: [ 'select' ]
@@ -4952 +5077 @@
                 /**
                  * Frame mode deactivation event.
                  *
-                 * @event this#{mode}:deactivate
+                 * @event wp.media.view.Frame#{mode}:deactivate
                  */
                 this.trigger( mode + ':deactivate' );
 
@@ -4975 +5100 @@
 module.exports = Frame;
 
 },{}],44:[function(require,module,exports){
+var Select = wp.media.view.MediaFrame.Select,
+        l10n = wp.media.view.l10n,
+        ImageDetails;
+
 /**
  * wp.media.view.MediaFrame.ImageDetails
  *
  * A media frame for manipulating an image that's already been inserted
  * into a post.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -4990 +5121 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        l10n = wp.media.view.l10n,
-        ImageDetails;
-
-ImageDetails = Select.extend({
+ImageDetails = Select.extend(/** @lends wp.media.view.MediaFrame.ImageDetails.prototype */{
         defaults: {
                 id:      'image',
                 url:     '',
@@ -5153 +5280 @@
 module.exports = ImageDetails;
 
 },{}],45:[function(require,module,exports){
+var Select = wp.media.view.MediaFrame.Select,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        Post;
+
 /**
  * wp.media.view.MediaFrame.Post
  *
  * The frame for manipulating media on the Edit Post page.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -5167 +5301 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        Post;
-
-Post = Select.extend({
+Post = Select.extend(/** @lends wp.media.view.MediaFrame.Post.prototype */{
         initialize: function() {
                 this.counts = {
                         audio: {
@@ -5598 +5727 @@
                         requires: { selection: true },
 
                         /**
+                         * @callback
                          * @fires wp.media.controller.State#insert
                          */
                         click: function() {
@@ -5888 +6018 @@
 module.exports = Post;
 
 },{}],46:[function(require,module,exports){
+var MediaFrame = wp.media.view.MediaFrame,
+        l10n = wp.media.view.l10n,
+        Select;
+
 /**
  * wp.media.view.MediaFrame.Select
  *
  * A frame for selecting an item or items from the media library.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame
  * @augments wp.media.view.Frame
@@ -5901 +6037 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-
-var MediaFrame = wp.media.view.MediaFrame,
-        l10n = wp.media.view.l10n,
-        Select;
-
-Select = MediaFrame.extend({
+Select = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Select.prototype */{
         initialize: function() {
                 // Call 'initialize' directly on the parent class.
                 MediaFrame.prototype.initialize.apply( this, arguments );
@@ -6062 +6193 @@
 /**
  * wp.media.view.Iframe
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Iframe = wp.media.View.extend({
+var Iframe = wp.media.View.extend(/** @lends wp.media.view.Iframe.prototype */{
         className: 'media-iframe',
         /**
          * @returns {wp.media.view.Iframe} Returns itself to allow chaining
@@ -6083 +6216 @@
 module.exports = Iframe;
 
 },{}],48:[function(require,module,exports){
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        $ = jQuery,
+        ImageDetails;
+
 /**
  * wp.media.view.ImageDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -6093 +6232 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        $ = jQuery,
-        ImageDetails;
-
-ImageDetails = AttachmentDisplay.extend({
+ImageDetails = AttachmentDisplay.extend(/** @lends wp.media.view.ImageDetails.prototype */{
         className: 'image-details',
         template:  wp.template('image-details'),
         events: _.defaults( AttachmentDisplay.prototype.events, {
@@ -6254 +6389 @@
 /**
  * wp.media.view.Label
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Label = wp.media.View.extend({
+var Label = wp.media.View.extend(/** @lends wp.media.view.Label.prototype */{
         tagName: 'label',
         className: 'screen-reader-text',
 
@@ -6277 +6414 @@
 module.exports = Label;
 
 },{}],50:[function(require,module,exports){
+var Frame = wp.media.view.Frame,
+        $ = jQuery,
+        MediaFrame;
+
 /**
  * wp.media.view.MediaFrame
  *
  * The frame used to create the media modal.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Frame
  * @augments wp.media.View
@@ -6289 +6432 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.view.Frame,
-        $ = jQuery,
-        MediaFrame;
-
-MediaFrame = Frame.extend({
+MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
         className: 'media-frame',
         template:  wp.template('media-frame'),
         regions:   ['menu','title','content','toolbar','router'],
@@ -6303 +6442 @@
         },
 
         /**
-         * @global wp.Uploader
+         * @constructs
          */
         initialize: function() {
                 Frame.prototype.initialize.apply( this, arguments );
@@ -6511 +6650 @@
 // Map some of the modal's methods to the frame.
 _.each(['open','close','attach','detach','escape'], function( method ) {
         /**
+         * @function open
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function close
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function attach
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function detach
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function escape
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
          */
         MediaFrame.prototype[ method ] = function() {
@@ -6524 +6695 @@
 module.exports = MediaFrame;
 
 },{}],51:[function(require,module,exports){
+var $ = jQuery,
+        MenuItem;
+
 /**
  * wp.media.view.MenuItem
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        MenuItem;
-
-MenuItem = wp.media.View.extend({
+MenuItem = wp.media.View.extend(/** @lends wp.media.view.MenuItem.prototype */{
         tagName:   'a',
         className: 'media-menu-item',
 
@@ -6596 +6769 @@
 module.exports = MenuItem;
 
 },{}],52:[function(require,module,exports){
+var MenuItem = wp.media.view.MenuItem,
+        PriorityList = wp.media.view.PriorityList,
+        Menu;
+
 /**
  * wp.media.view.Menu
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.PriorityList
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MenuItem = wp.media.view.MenuItem,
-        PriorityList = wp.media.view.PriorityList,
-        Menu;
-
-Menu = PriorityList.extend({
+Menu = PriorityList.extend(/** @lends wp.media.view.Menu.prototype */{
         tagName:   'div',
         className: 'media-menu',
         property:  'state',
@@ -6713 +6888 @@
 module.exports = Menu;
 
 },{}],53:[function(require,module,exports){
+var $ = jQuery,
+        Modal;
+
 /**
  * wp.media.view.Modal
  *
  * A modal view, which the media modal uses as its default container.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        Modal;
-
-Modal = wp.media.View.extend({
+Modal = wp.media.View.extend(/** @lends wp.media.view.Modal.prototype */{
         tagName:  'div',
         template: wp.template('media-modal'),
 
@@ -6937 +7114 @@
 /**
  * wp.media.view.PriorityList
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var PriorityList = wp.media.View.extend({
+var PriorityList = wp.media.View.extend(/** @lends wp.media.view.PriorityList.prototype */{
         tagName:   'div',
 
         initialize: function() {
@@ -7034 +7213 @@
 /**
  * wp.media.view.RouterItem
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MenuItem
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var RouterItem = wp.media.view.MenuItem.extend({
+var RouterItem = wp.media.view.MenuItem.extend(/** @lends wp.media.view.RouterItem.prototype */{
         /**
          * On click handler to activate the content region's corresponding mode.
          */
@@ -7055 +7236 @@
 module.exports = RouterItem;
 
 },{}],56:[function(require,module,exports){
+var Menu = wp.media.view.Menu,
+        Router;
+
 /**
  * wp.media.view.Router
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Menu
  * @augments wp.media.view.PriorityList
@@ -7065 +7251 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Menu = wp.media.view.Menu,
-        Router;
-
-Router = Menu.extend({
+Router = Menu.extend(/** @lends wp.media.view.Router.prototype */{
         tagName:   'div',
         className: 'media-router',
         property:  'contentMode',
@@ -7092 +7275 @@
 module.exports = Router;
 
 },{}],57:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        Search;
+
 /**
  * wp.media.view.Search
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Search;
-
-Search = wp.media.View.extend({
+Search = wp.media.View.extend(/** @lends wp.media.view.Search.prototype */{
         tagName:   'input',
         className: 'search',
         id:        'media-search-input',
@@ -7138 +7323 @@
 module.exports = Search;
 
 },{}],58:[function(require,module,exports){
+var l10n = wp.media.view.l10n,
+        Selection;
+
 /**
  * wp.media.view.Selection
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Selection;
-
-Selection = wp.media.View.extend({
+Selection = wp.media.View.extend(/** @lends wp.media.view.Selection.prototype */{
         tagName:   'div',
         className: 'media-selection',
         template:  wp.template('media-selection'),
@@ -7221 +7408 @@
 module.exports = Selection;
 
 },{}],59:[function(require,module,exports){
+var View = wp.media.View,
+        $ = Backbone.$,
+        Settings;
+
 /**
  * wp.media.view.Settings
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = Backbone.$,
-        Settings;
-
-Settings = View.extend({
+Settings = View.extend(/** @lends wp.media.view.Settings.prototype */{
         events: {
                 'click button':    'updateHandler',
                 'change input':    'updateHandler',
@@ -7342 +7531 @@
 module.exports = Settings;
 
 },{}],60:[function(require,module,exports){
+var Settings = wp.media.view.Settings,
+        AttachmentDisplay;
+
 /**
  * wp.media.view.Settings.AttachmentDisplay
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Settings = wp.media.view.Settings,
-        AttachmentDisplay;
-
-AttachmentDisplay = Settings.extend({
+AttachmentDisplay = Settings.extend(/** @lends wp.media.view.Settings.AttachmentDisplay.prototype */{
         className: 'attachment-display-settings',
         template:  wp.template('attachment-display-settings'),
 
@@ -7439 +7630 @@
 /**
  * wp.media.view.Settings.Gallery
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Gallery = wp.media.view.Settings.extend({
+var Gallery = wp.media.view.Settings.extend(/** @lends wp.media.view.Settings.Gallery.prototype */{
         className: 'collection-settings gallery-settings',
         template:  wp.template('gallery-settings')
 });
@@ -7456 +7649 @@
 /**
  * wp.media.view.Settings.Playlist
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Playlist = wp.media.view.Settings.extend({
+var Playlist = wp.media.view.Settings.extend(/** @lends wp.media.view.Settings.Playlist.prototype */{
         className: 'collection-settings playlist-settings',
         template:  wp.template('playlist-settings')
 });
@@ -7473 +7668 @@
 /**
  * wp.media.view.Sidebar
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.PriorityList
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Sidebar = wp.media.view.PriorityList.extend({
+var Sidebar = wp.media.view.PriorityList.extend(/** @lends wp.media.view.Sidebar.prototype */{
         className: 'media-sidebar'
 });
 
 module.exports = Sidebar;
 
 },{}],64:[function(require,module,exports){
+var View = wp.media.view,
+        SiteIconCropper;
+
 /**
  * wp.media.view.SiteIconCropper
  *
@@ -7494 +7694 @@
  * Takes imgAreaSelect options from
  * wp.customize.SiteIconControl.calculateImageSelectOptions.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Cropper
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.view,
-        SiteIconCropper;
-
-SiteIconCropper = View.Cropper.extend({
+SiteIconCropper = View.Cropper.extend(/** @lends wp.media.view.SiteIconCropper.prototype */{
         className: 'crop-content site-icon',
 
         ready: function () {
@@ -7529 +7728 @@
 module.exports = SiteIconCropper;
 
 },{}],65:[function(require,module,exports){
+var View = wp.media.View,
+        $ = jQuery,
+        SiteIconPreview;
+
 /**
  * wp.media.view.SiteIconPreview
  *
  * Shows a preview of the Site Icon as a favicon and app icon while cropping.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        SiteIconPreview;
-
-SiteIconPreview = View.extend({
+SiteIconPreview = View.extend(/** @lends wp.media.view.SiteIconPreview.prototype */{
         className: 'site-icon-preview',
         template: wp.template( 'site-icon-preview' ),
 
@@ -7588 +7789 @@
 /**
  * wp.media.view.Spinner
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Spinner = wp.media.View.extend({
+var Spinner = wp.media.View.extend(/** @lends wp.media.view.Spinner.prototype */{
         tagName:   'span',
         className: 'spinner',
         spinnerTimeout: false,
@@ -7620 +7823 @@
 module.exports = Spinner;
 
 },{}],67:[function(require,module,exports){
+var View = wp.media.View,
+        Toolbar;
+
 /**
  * wp.media.view.Toolbar
  *
  * A toolbar which consists of a primary and a secondary section. Each sections
  * can be filled with views.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        Toolbar;
-
-Toolbar = View.extend({
+Toolbar = View.extend(/** @lends wp.media.view.Toolbar.prototype */{
         tagName:   'div',
         className: 'media-toolbar',
 
@@ -7782 +7987 @@
 module.exports = Toolbar;
 
 },{}],68:[function(require,module,exports){
+var Select = wp.media.view.Toolbar.Select,
+        l10n = wp.media.view.l10n,
+        Embed;
+
 /**
  * wp.media.view.Toolbar.Embed
  *
+ * @memberOf wp.media.view.Toolbar
+ *
  * @class
  * @augments wp.media.view.Toolbar.Select
  * @augments wp.media.view.Toolbar
@@ -7792 +8003 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Select = wp.media.view.Toolbar.Select,
-        l10n = wp.media.view.l10n,
-        Embed;
-
-Embed = Select.extend({
+Embed = Select.extend(/** @lends wp.media.view.Toolbar.Embed.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         text: l10n.insertIntoPost,
@@ -7819 +8026 @@
 module.exports = Embed;
 
 },{}],69:[function(require,module,exports){
+var Toolbar = wp.media.view.Toolbar,
+        l10n = wp.media.view.l10n,
+        Select;
+
 /**
  * wp.media.view.Toolbar.Select
  *
+ * @memberOf wp.media.view.Toolbar
+ *
  * @class
  * @augments wp.media.view.Toolbar
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Toolbar = wp.media.view.Toolbar,
-        l10n = wp.media.view.l10n,
-        Select;
-
-Select = Toolbar.extend({
+Select = Toolbar.extend(/** @lends wp.media.view.Toolbar.Select.prototype */{
         initialize: function() {
                 var options = this.options;
 
@@ -7889 +8098 @@
 module.exports = Select;
 
 },{}],70:[function(require,module,exports){
+var View = wp.media.View,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        EditorUploader;
+
 /**
  * Creates a dropzone on WP editor instances (elements with .wp-editor-wrap)
  * and relays drag'n'dropped files to a media workflow.
  *
  * wp.media.view.EditorUploader
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        EditorUploader;
-
-EditorUploader = View.extend({
+EditorUploader = View.extend(/** @lends wp.media.view.EditorUploader.prototype */{
         tagName:   'div',
         className: 'uploader-editor',
         template:  wp.template( 'uploader-editor' ),
@@ -8114 +8325 @@
 module.exports = EditorUploader;
 
 },{}],71:[function(require,module,exports){
+var View = wp.media.View,
+        UploaderInline;
+
 /**
  * wp.media.view.UploaderInline
  *
  * The inline uploader that shows up in the 'Upload Files' tab.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderInline;
-
-UploaderInline = View.extend({
+UploaderInline = View.extend(/** @lends wp.media.view.UploaderInline.prototype */{
         tagName:   'div',
         className: 'uploader-inline',
         template:  wp.template('uploader-inline'),
@@ -8257 +8470 @@
 /**
  * wp.media.view.UploaderStatusError
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var UploaderStatusError = wp.media.View.extend({
+var UploaderStatusError = wp.media.View.extend(/** @lends wp.media.view.UploaderStatusError.prototype */{
         className: 'upload-error',
         template:  wp.template('uploader-status-error')
 });
@@ -8270 +8485 @@
 module.exports = UploaderStatusError;
 
 },{}],73:[function(require,module,exports){
+var View = wp.media.View,
+        UploaderStatus;
+
 /**
  * wp.media.view.UploaderStatus
  *
  * An uploader status for on-going uploads.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderStatus;
-
-UploaderStatus = View.extend({
+UploaderStatus = View.extend(/** @lends wp.media.view.UploaderStatus.prototype */{
         className: 'media-uploader-status',
         template:  wp.template('uploader-status'),
 
@@ -8303 +8520 @@
                 this.errors.on( 'add', this.error, this );
         },
         /**
-         * @global wp.Uploader
          * @returns {wp.media.view.UploaderStatus}
          */
         dispose: function() {
@@ -8389 +8605 @@
         },
 
         /**
-         * @global wp.Uploader
-         *
          * @param {Object} event
          */
         dismiss: function( event ) {
@@ -8408 +8622 @@
 module.exports = UploaderStatus;
 
 },{}],74:[function(require,module,exports){
+var $ = jQuery,
+        UploaderWindow;
+
 /**
  * wp.media.view.UploaderWindow
  *
  * An uploader window that allows for dragging and dropping media.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
@@ -8424 +8643 @@
  * @param {jQuery} [options.uploader.dropzone] jQuery collection of the dropzone.
  * @param {object} [options.uploader.params]
  */
-var $ = jQuery,
-        UploaderWindow;
-
-UploaderWindow = wp.media.View.extend({
+UploaderWindow = wp.media.View.extend(/** @lends wp.media.view.UploaderWindow.prototype */{
         tagName:   'div',
         className: 'uploader-window',
         template:  wp.template('uploader-window'),
@@ -8531 +8747 @@
  * This behavior has since been removed, and should not be used
  * outside of the media manager.
  *
+ * @memberOf wp.media
+ *
  * @class
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.Backbone.View.extend({
+var View = wp.Backbone.View.extend(/** @lends wp.media.View.prototype */{
         constructor: function( options ) {
                 if ( options && options.controller ) {
                         this.controller = options.controller;

src/wp-includes/js/media/controllers/audio-details.js

@@ +1 @@
+var State = wp.media.controller.State,
+        l10n = wp.media.view.l10n,
+        AudioDetails;
+
 /**
  * wp.media.controller.AudioDetails
  *
  * The controller for the Audio Details state
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var State = wp.media.controller.State,
-        l10n = wp.media.view.l10n,
-        AudioDetails;
-
-AudioDetails = State.extend({
+AudioDetails = State.extend(/** @lends wp.media.controller.AudioDetails.prototype */{
         defaults: {
                 id: 'audio-details',
                 toolbar: 'audio-details',

src/wp-includes/js/media/controllers/collection-add.js

@@ +1 @@
+var Selection = wp.media.model.Selection,
+        Library = wp.media.controller.Library,
+        CollectionAdd;
+
 /**
  * wp.media.controller.CollectionAdd
  *
  * A state for adding attachments to a collection (e.g. video playlist).
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -31 +37 @@
  * @param {string}                     attributes.type                   The collection's media type. (e.g. 'video').
  * @param {string}                     attributes.collectionType         The collection type. (e.g. 'playlist').
  */
-var Selection = wp.media.model.Selection,
-        Library = wp.media.controller.Library,
-        CollectionAdd;
-
-CollectionAdd = Library.extend({
+CollectionAdd = Library.extend(/** @lends wp.media.controller.CollectionAdd.prototype */{
         defaults: _.defaults( {
                 // Selection defaults. @see media.model.Selection
                 multiple:      'add',

src/wp-includes/js/media/controllers/collection-edit.js

@@ +1 @@
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        CollectionEdit;
+
 /**
  * wp.media.controller.CollectionEdit
  *
  * A state for editing a collection, which is used by audio and video playlists,
  * and can be used for other collections.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -33 +40 @@
  * @param {string}                     attributes.type                   The collection's media type. (e.g. 'video').
  * @param {string}                     attributes.collectionType         The collection type. (e.g. 'playlist').
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        CollectionEdit;
-
-CollectionEdit = Library.extend({
+CollectionEdit = Library.extend(/** @lends wp.media.controller.CollectionEdit.prototype */{
         defaults: {
                 multiple:         false,
                 sortable:         true,

src/wp-includes/js/media/controllers/cropper.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        Cropper;
+
 /**
  * wp.media.controller.Cropper
  *
  * A state for cropping an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var l10n = wp.media.view.l10n,
-        Cropper;
-
-Cropper = wp.media.controller.State.extend({
+Cropper = wp.media.controller.State.extend(/** @lends wp.media.controller.Cropper.prototype */{
         defaults: {
                 id:          'cropper',
                 title:       l10n.cropImage,

src/wp-includes/js/media/controllers/customize-image-cropper.js

@@ +1 @@
+var Controller = wp.media.controller,
+        CustomizeImageCropper;
+
 /**
  * wp.media.controller.CustomizeImageCropper
  *
+ * @memberOf wp.media.controller
+ *
  * A state for cropping an image.
  *
  * @class
@@ -8 +13 @@
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var Controller = wp.media.controller,
-        CustomizeImageCropper;
-
-CustomizeImageCropper = Controller.Cropper.extend({
+CustomizeImageCropper = Controller.Cropper.extend(/** @lends wp.media.controller.CustomizeImageCropper.prototype */{
         doCrop: function( attachment ) {
                 var cropDetails = attachment.get( 'cropDetails' ),
                         control = this.get( 'control' ),

src/wp-includes/js/media/controllers/edit-attachment-metadata.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        EditAttachmentMetadata;
+
 /**
  * wp.media.controller.EditAttachmentMetadata
  *
  * A state for editing an attachment's metadata.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var l10n = wp.media.view.l10n,
-        EditAttachmentMetadata;
-
-EditAttachmentMetadata = wp.media.controller.State.extend({
+EditAttachmentMetadata = wp.media.controller.State.extend(/** @lends wp.media.controller.EditAttachmentMetadata.prototype */{
         defaults: {
                 id:      'edit-attachment',
                 // Title string passed to the frame's title region view.

src/wp-includes/js/media/controllers/edit-image.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        EditImage;
+
 /**
  * wp.media.controller.EditImage
  *
  * A state for editing (cropping, etc.) an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -16 +21 @@
  * @param {string}                    [attributes.menu=false]         Initial mode for the menu region.
  * @param {string}                    [attributes.url]                Unused. @todo Consider removal.
  */
-var l10n = wp.media.view.l10n,
-        EditImage;
-
-EditImage = wp.media.controller.State.extend({
+EditImage = wp.media.controller.State.extend(/** @lends wp.media.controller.EditImage.prototype */{
         defaults: {
                 id:      'edit-image',
                 title:   l10n.editImage,

src/wp-includes/js/media/controllers/embed.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        $ = Backbone.$,
+        Embed;
+
 /**
  * wp.media.controller.Embed
  *
  * A state for embedding media from a URL.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -19 +25 @@
  * @param {string} [attributes.url]                   The embed URL.
  * @param {object} [attributes.metadata={}]           Properties of the embed, which will override attributes.url if set.
  */
-var l10n = wp.media.view.l10n,
-        $ = Backbone.$,
-        Embed;
-
-Embed = wp.media.controller.State.extend({
+Embed = wp.media.controller.State.extend(/** @lends wp.media.controller.Embed.prototype */{
         defaults: {
                 id:       'embed',
                 title:    l10n.insertFromUrlTitle,

src/wp-includes/js/media/controllers/featured-image.js

@@ +1 @@
+var Attachment = wp.media.model.Attachment,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        FeaturedImage;
+
 /**
  * wp.media.controller.FeaturedImage
  *
  * A state for selecting a featured image for a post.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -29 +36 @@
  * @param {boolean}                    [attributes.contentUserSetting=true]  Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                    [attributes.syncSelection=true]       Whether the Attachments selection should be persisted from the last state.
  */
-var Attachment = wp.media.model.Attachment,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        FeaturedImage;
-
-FeaturedImage = Library.extend({
+FeaturedImage = Library.extend(/** @lends wp.media.controller.FeaturedImage.prototype */{
         defaults: _.defaults({
                 id:            'featured-image',
                 title:         l10n.setFeaturedImageTitle,

src/wp-includes/js/media/controllers/gallery-add.js

@@ +1 @@
+var Selection = wp.media.model.Selection,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        GalleryAdd;
+
 /**
  * wp.media.controller.GalleryAdd
  *
  * A state for selecting more images to add to a gallery.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -29 +36 @@
  * @param {boolean}                    [attributes.syncSelection=false]     Whether the Attachments selection should be persisted from the last state.
  *                                                                          Defaults to false because for this state, because the library of the Edit Gallery state is the selection.
  */
-var Selection = wp.media.model.Selection,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        GalleryAdd;
-
-GalleryAdd = Library.extend({
+GalleryAdd = Library.extend(/** @lends wp.media.controller.GalleryAdd.prototype */{
         defaults: _.defaults({
                 id:            'gallery-library',
                 title:         l10n.addToGalleryTitle,

src/wp-includes/js/media/controllers/gallery-edit.js

@@ +1 @@
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        GalleryEdit;
+
 /**
  * wp.media.controller.GalleryEdit
  *
  * A state for editing a gallery's images and settings.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -30 +36 @@
  * @param {view}                       [attributes.AttachmentView]        The single `Attachment` view to be used in the `Attachments`.
  *                                                                        If none supplied, defaults to wp.media.view.Attachment.EditLibrary.
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        GalleryEdit;
-
-GalleryEdit = Library.extend({
+GalleryEdit = Library.extend(/** @lends wp.media.controller.GalleryEdit.prototype */{
         defaults: {
                 id:               'gallery-edit',
                 title:            l10n.editGalleryTitle,

src/wp-includes/js/media/controllers/image-details.js

@@ +1 @@
+var State = wp.media.controller.State,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        ImageDetails;
+
 /**
  * wp.media.controller.ImageDetails
  *
  * A state for editing the attachment display settings of an image that's been
  * inserted into the editor.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -22 +29 @@
  * @todo This state inherits some defaults from media.controller.Library.prototype.defaults,
  *       however this may not do anything.
  */
-var State = wp.media.controller.State,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        ImageDetails;
-
-ImageDetails = State.extend({
+ImageDetails = State.extend(/** @lends wp.media.controller.ImageDetails.prototype */{
         defaults: _.defaults({
                 id:       'image-details',
                 title:    l10n.imageDetailsTitle,

src/wp-includes/js/media/controllers/library.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        getUserSetting = window.getUserSetting,
+        setUserSetting = window.setUserSetting,
+        Library;
+
 /**
  * wp.media.controller.Library
  *
  * A state for choosing an attachment or group of attachments from the media library.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -32 +39 @@
  * @param {boolean}                         [attributes.contentUserSetting=true] Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                         [attributes.syncSelection=true]      Whether the Attachments selection should be persisted from the last state.
  */
-var l10n = wp.media.view.l10n,
-        getUserSetting = window.getUserSetting,
-        setUserSetting = window.setUserSetting,
-        Library;
-
-Library = wp.media.controller.State.extend({
+Library = wp.media.controller.State.extend(/** @lends wp.media.controller.Library.prototype */{
         defaults: {
                 id:                 'library',
                 title:              l10n.mediaLibraryTitle,

src/wp-includes/js/media/controllers/media-library.js

@@ -1 +1 @@
 /**
  * wp.media.controller.MediaLibrary
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -9 +11 @@
 var Library = wp.media.controller.Library,
         MediaLibrary;
 
-MediaLibrary = Library.extend({
+MediaLibrary = Library.extend(/** @lends wp.media.controller.MediaLibrary.prototype */{
         defaults: _.defaults({
                 // Attachments browser defaults. @see media.view.AttachmentsBrowser
                 filterable:      'uploaded',

src/wp-includes/js/media/controllers/region.js

@@ -11 +11 @@
  * 'browse' mode t be activated on the 'content' view and then fills the region
  * with an AttachmentsBrowser view.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  *
  * @param {object}        options          Options hash for the region.
@@ -25 +27 @@
 // Use Backbone's self-propagating `extend` inheritance method.
 Region.extend = Backbone.Model.extend;
 
-_.extend( Region.prototype, {
+_.extend( Region.prototype,/** @lends wp.media.controller.Region.prototype */{
         /**
          * Activate a mode.
          *
@@ -33 +35 @@
          *
          * @param {string} mode
          *
-         * @fires this.view#{this.id}:activate:{this._mode}
-         * @fires this.view#{this.id}:activate
-         * @fires this.view#{this.id}:deactivate:{this._mode}
-         * @fires this.view#{this.id}:deactivate
+         * @fires Region#activate
+         * @fires Region#deactivate
          *
          * @returns {wp.media.controller.Region} Returns itself to allow chaining.
          */
@@ -52 +52 @@
                 /**
                  * Region mode deactivation event.
                  *
-                 * @event this.view#{this.id}:deactivate:{this._mode}
-                 * @event this.view#{this.id}:deactivate
+                 * @event wp.media.controller.Region#deactivate
                  */
                 this.trigger('deactivate');
 
@@ -63 +62 @@
                 /**
                  * Region mode activation event.
                  *
-                 * @event this.view#{this.id}:activate:{this._mode}
-                 * @event this.view#{this.id}:activate
+                 * @event wp.media.controller.Region#activate
                  */
                 this.trigger('activate');
                 return this;
@@ -76 +74 @@
          *
          * @param {string} mode
          *
-         * @fires this.view#{this.id}:create:{this._mode}
-         * @fires this.view#{this.id}:create
-         * @fires this.view#{this.id}:render:{this._mode}
-         * @fires this.view#{this.id}:render
+         * @fires Region#create
+         * @fires Region#render
          *
          * @returns {wp.media.controller.Region} Returns itself to allow chaining
          */
@@ -97 +93 @@
                  *
                  * Region view creation takes place in an event callback on the frame.
                  *
-                 * @event this.view#{this.id}:create:{this._mode}
-                 * @event this.view#{this.id}:create
+                 * @event wp.media.controller.Region#create
+                 * @type {object}
+                 * @property {object} view
                  */
                 this.trigger( 'create', set );
                 view = set.view;
@@ -108 +105 @@
                  *
                  * Region view creation takes place in an event callback on the frame.
                  *
-                 * @event this.view#{this.id}:create:{this._mode}
-                 * @event this.view#{this.id}:create
+                 * @event wp.media.controller.Region#render
+                 * @type {object}
                  */
                 this.trigger( 'render', view );
                 if ( view ) {

src/wp-includes/js/media/controllers/replace-image.js

@@ +1 @@
+var Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        ReplaceImage;
+
 /**
  * wp.media.controller.ReplaceImage
  *
  * A state for replacing an image.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Library
  * @augments wp.media.controller.State
@@ -29 +35 @@
  * @param {boolean}                    [attributes.contentUserSetting=true] Whether the content region's mode should be set and persisted per user.
  * @param {boolean}                    [attributes.syncSelection=true]      Whether the Attachments selection should be persisted from the last state.
  */
-var Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        ReplaceImage;
-
-ReplaceImage = Library.extend({
+ReplaceImage = Library.extend(/** @lends wp.media.controller.ReplaceImage.prototype */{
         defaults: _.defaults({
                 id:            'replace-image',
                 title:         l10n.replaceImageTitle,

src/wp-includes/js/media/controllers/site-icon-cropper.js

@@ +1 @@
+var Controller = wp.media.controller,
+        SiteIconCropper;
+
 /**
  * wp.media.controller.SiteIconCropper
  *
  * A state for cropping a Site Icon.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.Cropper
  * @augments wp.media.controller.State
  * @augments Backbone.Model
  */
-var Controller = wp.media.controller,
-        SiteIconCropper;
-
-SiteIconCropper = Controller.Cropper.extend({
+SiteIconCropper = Controller.Cropper.extend(/** @lends wp.media.controller.SiteIconCropper.prototype */{
         activate: function() {
                 this.frame.on( 'content:create:crop', this.createCropContent, this );
                 this.frame.on( 'close', this.removeCropper, this );

src/wp-includes/js/media/controllers/state-machine.js

@@ -6 +6 @@
  *
  * States are stored as models in a Backbone collection.
  *
+ * @memberOf wp.media.controller
+ *
  * @since 3.5.0
  *
  * @class
@@ -23 +25 @@
 // Use Backbone's self-propagating `extend` inheritance method.
 StateMachine.extend = Backbone.Model.extend;
 
-_.extend( StateMachine.prototype, Backbone.Events, {
+_.extend( StateMachine.prototype, Backbone.Events,/** @lends wp.media.controller.StateMachine.prototype */{
         /**
          * Fetch a state.
          *
@@ -107 +109 @@
 // Map all event binding and triggering on a StateMachine to its `states` collection.
 _.each([ 'on', 'off', 'trigger' ], function( method ) {
         /**
+         * @function on
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
+         */
+        /**
+         * @function off
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
+         * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
+         */
+        /**
+         * @function trigger
+         * @memberOf wp.media.controller.StateMachine
+         * @instance
          * @returns {wp.media.controller.StateMachine} Returns itself to allow chaining.
          */
         StateMachine.prototype[ method ] = function() {

src/wp-includes/js/media/controllers/state.js

@@ -12 +12 @@
  *     'reset'      is not triggered automatically. It should be invoked by the
  *                  proper controller to reset the state to its default.
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments Backbone.Model
  */
-var State = Backbone.Model.extend({
+var State = Backbone.Model.extend(/** @lends wp.media.controller.State.prototype */{
         /**
          * Constructor.
          *

src/wp-includes/js/media/controllers/video-details.js

@@ -3 +3 @@
  *
  * The controller for the Video Details state
  *
+ * @memberOf wp.media.controller
+ *
  * @class
  * @augments wp.media.controller.State
  * @augments Backbone.Model
@@ -11 +13 @@
         l10n = wp.media.view.l10n,
         VideoDetails;
 
-VideoDetails = State.extend({
+VideoDetails = State.extend(/** @lends wp.media.controller.VideoDetails.prototype */{
         defaults: {
                 id: 'video-details',
                 toolbar: 'video-details',

src/wp-includes/js/media/models.manifest.js

@@ -1 +1 @@
 var $ = jQuery,
         Attachment, Attachments, l10n, media;
 
+/** @namespace wp */
 window.wp = window.wp || {};
 
 /**
@@ -8 +9 @@
  *
  * Handles the default media experience.
  *
+ * @alias wp.media
+ * @memberOf wp
+ * @namespace
+ *
  * @param  {object} attributes The properties passed to the main media controller.
  * @return {wp.media.view.MediaFrame} A media workflow.
  */
@@ -46 +51 @@
         return frame;
 };
 
+/** @namespace wp.media.model */
+/** @namespace wp.media.view */
+/** @namespace wp.media.controller */
+/** @namespace wp.media.frames */
 _.extend( media, { model: {}, view: {}, controller: {}, frames: {} });
 
 // Link any localized strings.
@@ -89 +98 @@
         }
 };
 
-_.extend( media, {
+_.extend( media, /** @lends wp.media */{
         /**
          * media.template( id )
          *

src/wp-includes/js/media/models/attachment.js

@@ +1 @@
+var $ = Backbone.$,
+        Attachment;
+
 /**
  * wp.media.model.Attachment
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  */
-var $ = Backbone.$,
-        Attachment;
-
-Attachment = Backbone.Model.extend({
+Attachment = Backbone.Model.extend(/** @lends wp.media.model.Attachment.prototype */{
         /**
          * Triggered when attachment details change
          * Overrides Backbone.Model.sync
@@ -134 +136 @@
                         model.set( model.parse( resp, xhr ), options );
                 });
         }
-}, {
+},/** @lends wp.media.model.Attachment */{
         /**
          * Create a new model on the static 'all' attachments collection and return it.
          *
          * @static
+         *
          * @param {Object} attrs
          * @returns {wp.media.model.Attachment}
          */

src/wp-includes/js/media/models/attachments.js

@@ -7 +7 @@
  * 'options.props.query = true', which will mirror the collection
  * to an Attachments Query collection - @see wp.media.model.Attachments.mirror().
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Collection
  *
@@ -20 +22 @@
  * @param {string} [options.filters]
  *
  */
-var Attachments = Backbone.Collection.extend({
+var Attachments = Backbone.Collection.extend(/** @lends wp.media.model.Attachments.prototype */{
         /**
          * @type {wp.media.model.Attachment}
          */
@@ -418 +420 @@
                         attachments: attachments
                 });
         }
-}, {
+},/** @lends wp.media.model.Attachments */{
         /**
          * A function to compare two attachment models in an attachments collection.
          *
          * Used as the default comparator for instances of wp.media.model.Attachments
          * and its subclasses. @see wp.media.model.Attachments._changeOrderby().
          *
-         * @static
-         *
          * @param {Backbone.Model} a
          * @param {Backbone.Model} b
          * @param {Object} options
@@ -455 +455 @@
 
                 return ( 'DESC' === order ) ? wp.media.compare( a, b, ac, bc ) : wp.media.compare( b, a, bc, ac );
         },
-        /**
-         * @namespace
-         */
+        /** @namespace wp.media.model.Attachments.filters */
         filters: {
                 /**
                  * @static

src/wp-includes/js/media/models/post-image.js

@@ -5 +5 @@
  *
  * Used in the embedded image attachment display settings modal - @see wp.media.view.MediaFrame.ImageDetails.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  *
  * @param {int} [attributes]               Initial model attributes.
  * @param {int} [attributes.attachment_id] ID of the attachment.
  **/
-var PostImage = Backbone.Model.extend({
+var PostImage = Backbone.Model.extend(/** @lends wp.media.model.PostImage.prototype */{
 
         initialize: function( attributes ) {
                 var Attachment = wp.media.model.Attachment;

src/wp-includes/js/media/models/post-media.js

@@ -4 +4 @@
  * Shared model class for audio and video. Updates the model after
  *   "Add Audio|Video Source" and "Replace Audio|Video" states return
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments Backbone.Model
  */
-var PostMedia = Backbone.Model.extend({
+var PostMedia = Backbone.Model.extend(/** @lends wp.media.model.PostMedia.prototype */{
         initialize: function() {
                 this.attachment = false;
         },

src/wp-includes/js/media/models/query.js

@@ +1 @@
+var Attachments = wp.media.model.Attachments,
+        Query;
+
 /**
  * wp.media.model.Query
  *
@@ -6 +9 @@
  * Note: Do NOT change this.args after the query has been initialized.
  *       Things will break.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments wp.media.model.Attachments
  * @augments Backbone.Collection
@@ -15 +20 @@
  * @param {object} [options.args]                Attachments query arguments.
  * @param {object} [options.args.posts_per_page]
  */
-var Attachments = wp.media.model.Attachments,
-        Query;
-
-Query = Attachments.extend({
+Query = Attachments.extend(/** @lends wp.media.model.Query.prototype */{
         /**
-         * @global wp.Uploader
-         *
          * @param {array}  [models=[]]  Array of initial models to populate the collection.
          * @param {object} [options={}]
          */
@@ -153 +153 @@
                         return fallback.sync.apply( this, arguments );
                 }
         }
-}, {
+}, /** @lends wp.media.model.Query */{
         /**
          * @readonly
          */

src/wp-includes/js/media/models/selection.js

@@ +1 @@
+var Attachments = wp.media.model.Attachments,
+        Selection;
+
 /**
  * wp.media.model.Selection
  *
  * A selection of attachments.
  *
+ * @memberOf wp.media.model
+ *
  * @class
  * @augments wp.media.model.Attachments
  * @augments Backbone.Collection
  */
-var Attachments = wp.media.model.Attachments,
-        Selection;
-
-Selection = Attachments.extend({
+Selection = Attachments.extend(/** @lends wp.media.model.Selection.prototype */{
         /**
          * Refresh the `single` model whenever the selection changes.
          * Binds `single` instead of using the context argument to ensure

src/wp-includes/js/media/routers/manage.js

@@ -3 +3 @@
  *
  * A router for handling the browser history and application state.
  *
+ * @memberOf wp.media.view.MediaFrame.Manage
+ *
  * @class
  * @augments Backbone.Router
  */
-var Router = Backbone.Router.extend({
+var Router = Backbone.Router.extend(/** @lends wp.media.view.MediaFrame.Manage.Router.prototype */{
         routes: {
                 'upload.php?item=:slug&mode=edit': 'editItem',
                 'upload.php?item=:slug':           'showItem',

src/wp-includes/js/media/utils/selection-sync.js

@@ -6 +6 @@
  * Allows for selecting multiple images in the Insert Media workflow, and then
  * switching to the Insert Gallery workflow while preserving the attachments selection.
  *
+ * @memberOf wp.media
+ *
  * @mixin
  */
 var selectionSync = {

src/wp-includes/js/media/views/attachment-compat.js

@@ +1 @@
+var View = wp.media.View,
+        AttachmentCompat;
+
 /**
  * wp.media.view.AttachmentCompat
  *
  * A view to display fields added via the `attachment_fields_to_edit` filter.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        AttachmentCompat;
-
-AttachmentCompat = View.extend({
+AttachmentCompat = View.extend(/** @lends wp.media.view.AttachmentCompat.prototype */{
         tagName:   'form',
         className: 'compat-item',
 

src/wp-includes/js/media/views/attachment-filters.js

@@ +1 @@
+var $ = jQuery,
+        AttachmentFilters;
+
 /**
  * wp.media.view.AttachmentFilters
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        AttachmentFilters;
-
-AttachmentFilters = wp.media.View.extend({
+AttachmentFilters = wp.media.View.extend(/** @lends wp.media.view.AttachmentFilters.prototype */{
         tagName:   'select',
         className: 'attachment-filters',
         id:        'media-attachment-filters',

src/wp-includes/js/media/views/attachment-filters/all.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        All;
+
 /**
  * wp.media.view.AttachmentFilters.All
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        All;
-
-All = wp.media.view.AttachmentFilters.extend({
+All = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.All.prototype */{
         createFilters: function() {
                 var filters = {};
 

src/wp-includes/js/media/views/attachment-filters/date.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        DateFilter;
+
 /**
  * A filter dropdown for month/dates.
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        DateFilter;
-
-DateFilter = wp.media.view.AttachmentFilters.extend({
+DateFilter = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.Date.prototype */{
         id: 'media-attachment-date-filters',
 
         createFilters: function() {

src/wp-includes/js/media/views/attachment-filters/uploaded.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        Uploaded;
+
 /**
  * wp.media.view.AttachmentFilters.Uploaded
  *
+ * @memberOf wp.media.view.AttachmentFilters
+ *
  * @class
  * @augments wp.media.view.AttachmentFilters
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Uploaded;
-
-Uploaded = wp.media.view.AttachmentFilters.extend({
+Uploaded = wp.media.view.AttachmentFilters.extend(/** @lends wp.media.view.AttachmentFilters.Uploaded.prototype */{
         createFilters: function() {
                 var type = this.model.get('type'),
                         types = wp.media.view.settings.mimeTypes,

src/wp-includes/js/media/views/attachment.js

@@ +1 @@
+var View = wp.media.View,
+        $ = jQuery,
+        Attachment;
+
 /**
  * wp.media.view.Attachment
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        Attachment;
-
-Attachment = View.extend({
+Attachment = View.extend(/** @lends wp.media.view.Attachment.prototype */{
         tagName:   'li',
         className: 'attachment',
         template:  wp.template('attachment'),
@@ -518 +520 @@
         album:   '_syncAlbum'
 }, function( method, setting ) {
         /**
+         * @function _syncCaption
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncTitle
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncArtist
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
+         * @param {Backbone.Model} model
+         * @param {string} value
+         * @returns {wp.media.view.Attachment} Returns itself to allow chaining
+         */
+        /**
+         * @function _syncAlbum
+         * @memberOf wp.media.view.Attachment
+         * @instance
+         *
          * @param {Backbone.Model} model
          * @param {string} value
          * @returns {wp.media.view.Attachment} Returns itself to allow chaining

src/wp-includes/js/media/views/attachment/details-two-column.js

@@ +1 @@
+var Details = wp.media.view.Attachment.Details,
+        TwoColumn;
+
 /**
  * wp.media.view.Attachment.Details.TwoColumn
  *
  * A similar view to media.view.Attachment.Details
  * for use in the Edit Attachment modal.
  *
+ * @memberOf wp.media.view.Attachment.Details
+ *
  * @class
  * @augments wp.media.view.Attachment.Details
  * @augments wp.media.view.Attachment
@@ -11 +16 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Details = wp.media.view.Attachment.Details,
-        TwoColumn;
-
-TwoColumn = Details.extend({
+TwoColumn = Details.extend(/** @lends wp.media.view.Attachment.Details.TowColumn.prototype */{
         template: wp.template( 'attachment-details-two-column' ),
 
         initialize: function() {

src/wp-includes/js/media/views/attachment/details.js

@@ +1 @@
+var Attachment = wp.media.view.Attachment,
+        l10n = wp.media.view.l10n,
+        Details;
+
 /**
  * wp.media.view.Attachment.Details
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Attachment = wp.media.view.Attachment,
-        l10n = wp.media.view.l10n,
-        Details;
-
-Details = Attachment.extend({
+Details = Attachment.extend(/** @lends wp.media.view.Attachment.Details.prototype */{
         tagName:   'div',
         className: 'attachment-details',
         template:  wp.template('attachment-details'),

src/wp-includes/js/media/views/attachment/edit-library.js

@@ -1 +1 @@
 /**
  * wp.media.view.Attachment.EditLibrary
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var EditLibrary = wp.media.view.Attachment.extend({
+var EditLibrary = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.EditLibrary.prototype */{
         buttons: {
                 close: true
         }

src/wp-includes/js/media/views/attachment/edit-selection.js

@@ -1 +1 @@
 /**
- * wp.media.view.Attachments.EditSelection
+ * wp.media.view.Attachment.EditSelection
+ *
+ * @memberOf wp.media.view.Attachment
  *
  * @class
  * @augments wp.media.view.Attachment.Selection
@@ -8 +10 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var EditSelection = wp.media.view.Attachment.Selection.extend({
+var EditSelection = wp.media.view.Attachment.Selection.extend(/** @lends wp.media.view.Attachment.EditSelection.prototype */{
         buttons: {
                 close: true
         }

src/wp-includes/js/media/views/attachment/library.js

@@ -1 +1 @@
 /**
  * wp.media.view.Attachment.Library
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Library = wp.media.view.Attachment.extend({
+var Library = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.Library.prototype */{
         buttons: {
                 check: true
         }

src/wp-includes/js/media/views/attachment/selection.js

@@ -1 +1 @@
 /**
  * wp.media.view.Attachment.Selection
  *
+ * @memberOf wp.media.view.Attachment
+ *
  * @class
  * @augments wp.media.view.Attachment
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Selection = wp.media.view.Attachment.extend({
+var Selection = wp.media.view.Attachment.extend(/** @lends wp.media.view.Attachment.Selection.prototype */{
         className: 'attachment selection',
 
         // On click, just select the model, instead of removing the model from

src/wp-includes/js/media/views/attachments.js

@@ +1 @@
+var View = wp.media.View,
+        $ = jQuery,
+        Attachments;
+
 /**
  * wp.media.view.Attachments
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        Attachments;
-
-Attachments = View.extend({
+Attachments = View.extend(/** @lends wp.media.view.Attachments.prototype */{
         tagName:   'ul',
         className: 'attachments',
 

src/wp-includes/js/media/views/attachments/browser.js

@@ +1 @@
+var View = wp.media.View,
+        mediaTrash = wp.media.view.settings.mediaTrash,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        AttachmentsBrowser;
+
 /**
  * wp.media.view.AttachmentsBrowser
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
@@ -18 +26 @@
  * @param {boolean|string} [options.sidebar=true]  Whether to create a sidebar for the browser.
  *                                                 Accepts true, false, and 'errors'.
  */
-var View = wp.media.View,
-        mediaTrash = wp.media.view.settings.mediaTrash,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        AttachmentsBrowser;
-
-AttachmentsBrowser = View.extend({
+AttachmentsBrowser = View.extend(/** @lends wp.media.view.AttachmentsBrowser.prototype */{
         tagName:   'div',
         className: 'attachments-browser',
 

src/wp-includes/js/media/views/attachments/selection.js

@@ +1 @@
+var Attachments = wp.media.view.Attachments,
+        Selection;
+
 /**
  * wp.media.view.Attachments.Selection
  *
+ * @memberOf wp.media.view.Attachments
+ *
  * @class
  * @augments wp.media.view.Attachments
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Attachments = wp.media.view.Attachments,
-        Selection;
-
-Selection = Attachments.extend({
+Selection = Attachments.extend(/** @lends wp.media.view.Attachments.Selection.prototype */{
         events: {},
         initialize: function() {
                 _.defaults( this.options, {

src/wp-includes/js/media/views/audio-details.js

@@ +1 @@
+var MediaDetails = wp.media.view.MediaDetails,
+        AudioDetails;
+
 /**
  * wp.media.view.AudioDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MediaDetails
  * @augments wp.media.view.Settings.AttachmentDisplay
@@ -9 +14 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MediaDetails = wp.media.view.MediaDetails,
-        AudioDetails;
-
-AudioDetails = MediaDetails.extend({
+AudioDetails = MediaDetails.extend(/** @lends wp.media.view.AudioDetails.prototype */{
         className: 'audio-details',
         template:  wp.template('audio-details'),
 

src/wp-includes/js/media/views/button-group.js

@@ +1 @@
+var $ = Backbone.$,
+        ButtonGroup;
+
 /**
  * wp.media.view.ButtonGroup
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = Backbone.$,
-        ButtonGroup;
-
-ButtonGroup = wp.media.View.extend({
+ButtonGroup = wp.media.View.extend(/** @lends wp.media.view.ButtonGroup.prototype */{
         tagName:   'div',
         className: 'button-group button-large media-button-group',
 

src/wp-includes/js/media/views/button.js

@@ -1 +1 @@
 /**
  * wp.media.view.Button
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.View.extend({
+var Button = wp.media.View.extend(/** @lends wp.media.view.Button.prototype */{
         tagName:    'button',
         className:  'media-button',
         attributes: { type: 'button' },

src/wp-includes/js/media/views/button/delete-selected-permanently.js

@@ +1 @@
+var Button = wp.media.view.Button,
+        DeleteSelected = wp.media.view.DeleteSelectedButton,
+        DeleteSelectedPermanently;
+
 /**
  * wp.media.view.DeleteSelectedPermanentlyButton
  *
  * When MEDIA_TRASH is true, a button that handles bulk Delete Permanently logic
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.DeleteSelectedButton
  * @augments wp.media.view.Button
@@ -10 +16 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        DeleteSelected = wp.media.view.DeleteSelectedButton,
-        DeleteSelectedPermanently;
-
-DeleteSelectedPermanently = DeleteSelected.extend({
+DeleteSelectedPermanently = DeleteSelected.extend(/** @lends wp.media.view.DeleteSelectedPermanentlyButton.prototype */{
         initialize: function() {
                 DeleteSelected.prototype.initialize.apply( this, arguments );
                 this.controller.on( 'select:activate', this.selectActivate, this );

src/wp-includes/js/media/views/button/delete-selected.js

@@ +1 @@
+var Button = wp.media.view.Button,
+        l10n = wp.media.view.l10n,
+        DeleteSelected;
+
 /**
  * wp.media.view.DeleteSelectedButton
  *
  * A button that handles bulk Delete/Trash logic
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Button
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        l10n = wp.media.view.l10n,
-        DeleteSelected;
-
-DeleteSelected = Button.extend({
+DeleteSelected = Button.extend(/** @lends wp.media.view.DeleteSelectedButton.prototype */{
         initialize: function() {
                 Button.prototype.initialize.apply( this, arguments );
                 if ( this.options.filters ) {

src/wp-includes/js/media/views/button/select-mode-toggle.js

@@ +1 @@
+
+var Button = wp.media.view.Button,
+        l10n = wp.media.view.l10n,
+        SelectModeToggle;
+
 /**
  * wp.media.view.SelectModeToggleButton
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Button
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Button = wp.media.view.Button,
-        l10n = wp.media.view.l10n,
-        SelectModeToggle;
-
-SelectModeToggle = Button.extend({
+SelectModeToggle = Button.extend(/** @lends wp.media.view.SelectModeToggle.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         size : ''

src/wp-includes/js/media/views/cropper.js

@@ +1 @@
+var View = wp.media.View,
+        UploaderStatus = wp.media.view.UploaderStatus,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        Cropper;
+
 /**
  * wp.media.view.Cropper
  *
@@ -7 +13 @@
  * wp.customize.HeaderControl.calculateImageSelectOptions via
  * wp.customize.HeaderControl.openMM.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderStatus = wp.media.view.UploaderStatus,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        Cropper;
-
-Cropper = View.extend({
+Cropper = View.extend(/** @lends wp.media.view.Cropper.prototype */{
         className: 'crop-content',
         template: wp.template('crop-content'),
         initialize: function() {

src/wp-includes/js/media/views/edit-image-details.js

@@ +1 @@
+var View = wp.media.View,
+        EditImage = wp.media.view.EditImage,
+        Details;
+
 /**
  * wp.media.view.EditImage.Details
  *
+ * @memberOf wp.media.view.EditImage
+ *
  * @class
  * @augments wp.media.view.EditImage
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        EditImage = wp.media.view.EditImage,
-        Details;
-
-Details = EditImage.extend({
+Details = EditImage.extend(/** @lends wp.media.view.EditImage.Details.prototype */{
         initialize: function( options ) {
                 this.editor = window.imageEdit;
                 this.frame = options.frame;

src/wp-includes/js/media/views/edit-image.js

@@ +1 @@
+var View = wp.media.View,
+        EditImage;
+
 /**
  * wp.media.view.EditImage
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        EditImage;
-
-EditImage = View.extend({
+EditImage = View.extend(/** @lends wp.media.view.EditImage.prototype */{
         className: 'image-editor',
         template: wp.template('image-editor'),
 

src/wp-includes/js/media/views/embed.js

@@ -1 +1 @@
 /**
  * wp.media.view.Embed
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Embed = wp.media.View.extend({
+var Embed = wp.media.View.extend(/** @lends wp.media.view.Ember.prototype */{
         className: 'media-embed',
 
         initialize: function() {

src/wp-includes/js/media/views/embed/image.js

@@ +1 @@
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        EmbedImage;
+
 /**
  * wp.media.view.EmbedImage
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -8 +13 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        EmbedImage;
-
-EmbedImage = AttachmentDisplay.extend({
+EmbedImage = AttachmentDisplay.extend(/** @lends wp.media.view.EmbedImage.prototype */{
         className: 'embed-media-settings',
         template:  wp.template('embed-image-settings'),
 

src/wp-includes/js/media/views/embed/link.js

@@ +1 @@
+var $ = jQuery,
+        EmbedLink;
+
 /**
  * wp.media.view.EmbedLink
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        EmbedLink;
-
-EmbedLink = wp.media.view.Settings.extend({
+EmbedLink = wp.media.view.Settings.extend(/** @lends wp.media.view.EmbedLink.prototype */{
         className: 'embed-link-settings',
         template:  wp.template('embed-link-settings'),
 

src/wp-includes/js/media/views/embed/url.js

@@ +1 @@
+var View = wp.media.View,
+        $ = jQuery,
+        EmbedUrl;
+
 /**
  * wp.media.view.EmbedUrl
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        EmbedUrl;
-
-EmbedUrl = View.extend({
+EmbedUrl = View.extend(/** @lends wp.media.view.EmbedUrl.prototype */{
         tagName:   'label',
         className: 'embed-url',
 

src/wp-includes/js/media/views/focus-manager.js

@@ -1 +1 @@
 /**
  * wp.media.view.FocusManager
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var FocusManager = wp.media.View.extend({
+var FocusManager = wp.media.View.extend(/** @lends wp.media.view.FocusManager.prototype */{
 
         events: {
                 'keydown': 'constrainTabbing'

src/wp-includes/js/media/views/frame.js

@@ -4 +4 @@
  * A frame is a composite view consisting of one or more regions and one or more
  * states.
  *
+ * @memberOf wp.media.view
+ *
  * @see wp.media.controller.State
  * @see wp.media.controller.Region
  *
@@ -13 +15 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.View.extend({
+var Frame = wp.media.View.extend(/** @lends wp.media.view.Frame.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         mode: [ 'select' ]
@@ -141 +143 @@
                 /**
                  * Frame mode deactivation event.
                  *
-                 * @event this#{mode}:deactivate
+                 * @event wp.media.view.Frame#{mode}:deactivate
                  */
                 this.trigger( mode + ':deactivate' );
 

src/wp-includes/js/media/views/frame/audio-details.js

@@ +1 @@
+var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
+        MediaLibrary = wp.media.controller.MediaLibrary,
+
+        l10n = wp.media.view.l10n,
+        AudioDetails;
+
 /**
  * wp.media.view.MediaFrame.AudioDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.MediaDetails
  * @augments wp.media.view.MediaFrame.Select
@@ -11 +19 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
-        MediaLibrary = wp.media.controller.MediaLibrary,
-
-        l10n = wp.media.view.l10n,
-        AudioDetails;
-
-AudioDetails = MediaDetails.extend({
+AudioDetails = MediaDetails.extend(/** @lends wp.media.view.MediaFrame.AudioDetails.prototype */{
         defaults: {
                 id:      'audio',
                 url:     '',

src/wp-includes/js/media/views/frame/edit-attachments.js

@@ +1 @@
+var Frame = wp.media.view.Frame,
+        MediaFrame = wp.media.view.MediaFrame,
+
+        $ = jQuery,
+        EditAttachments;
+
 /**
  * wp.media.view.MediaFrame.EditAttachments
  *
@@ -7 +13 @@
  *
  * Requires an attachment model to be passed in the options hash under `model`.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.Frame
  * @augments wp.media.View
@@ -14 +22 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.view.Frame,
-        MediaFrame = wp.media.view.MediaFrame,
-
-        $ = jQuery,
-        EditAttachments;
-
-EditAttachments = MediaFrame.extend({
+EditAttachments = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.EditAttachments.prototype */{
 
         className: 'edit-attachment-frame',
         template:  wp.template( 'edit-attachment-frame' ),

src/wp-includes/js/media/views/frame/image-details.js

@@ +1 @@
+var Select = wp.media.view.MediaFrame.Select,
+        l10n = wp.media.view.l10n,
+        ImageDetails;
+
 /**
  * wp.media.view.MediaFrame.ImageDetails
  *
  * A media frame for manipulating an image that's already been inserted
  * into a post.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -13 +19 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        l10n = wp.media.view.l10n,
-        ImageDetails;
-
-ImageDetails = Select.extend({
+ImageDetails = Select.extend(/** @lends wp.media.view.MediaFrame.ImageDetails.prototype */{
         defaults: {
                 id:      'image',
                 url:     '',

src/wp-includes/js/media/views/frame/manage.js

@@ +1 @@
+var MediaFrame = wp.media.view.MediaFrame,
+        Library = wp.media.controller.Library,
+
+        $ = Backbone.$,
+        Manage;
+
 /**
  * wp.media.view.MediaFrame.Manage
  *
@@ -5 +11 @@
  *
  * Used in the media grid view.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame
  * @augments wp.media.view.Frame
@@ -13 +21 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaFrame = wp.media.view.MediaFrame,
-        Library = wp.media.controller.Library,
-
-        $ = Backbone.$,
-        Manage;
-
-Manage = MediaFrame.extend({
+Manage = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Manage.prototype */{
         /**
-         * @global wp.Uploader
+         * @constructs
          */
         initialize: function() {
                 _.defaults( this.options, {

src/wp-includes/js/media/views/frame/media-details.js

@@ +1 @@
+var Select = wp.media.view.MediaFrame.Select,
+        l10n = wp.media.view.l10n,
+        MediaDetails;
+
 /**
  * wp.media.view.MediaFrame.MediaDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -10 +16 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        l10n = wp.media.view.l10n,
-        MediaDetails;
-
-MediaDetails = Select.extend({
+MediaDetails = Select.extend(/** @lends wp.media.view.MediaFrame.MediaDetails.prototype */{
         defaults: {
                 id:      'media',
                 url:     '',

src/wp-includes/js/media/views/frame/post.js

@@ +1 @@
+var Select = wp.media.view.MediaFrame.Select,
+        Library = wp.media.controller.Library,
+        l10n = wp.media.view.l10n,
+        Post;
+
 /**
  * wp.media.view.MediaFrame.Post
  *
  * The frame for manipulating media on the Edit Post page.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.Select
  * @augments wp.media.view.MediaFrame
@@ -12 +19 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Select = wp.media.view.MediaFrame.Select,
-        Library = wp.media.controller.Library,
-        l10n = wp.media.view.l10n,
-        Post;
-
-Post = Select.extend({
+Post = Select.extend(/** @lends wp.media.view.MediaFrame.Post.prototype */{
         initialize: function() {
                 this.counts = {
                         audio: {
@@ -443 +445 @@
                         requires: { selection: true },
 
                         /**
+                         * @callback
                          * @fires wp.media.controller.State#insert
                          */
                         click: function() {

src/wp-includes/js/media/views/frame/select.js

@@ +1 @@
+var MediaFrame = wp.media.view.MediaFrame,
+        l10n = wp.media.view.l10n,
+        Select;
+
 /**
  * wp.media.view.MediaFrame.Select
  *
  * A frame for selecting an item or items from the media library.
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame
  * @augments wp.media.view.Frame
@@ -11 +17 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-
-var MediaFrame = wp.media.view.MediaFrame,
-        l10n = wp.media.view.l10n,
-        Select;
-
-Select = MediaFrame.extend({
+Select = MediaFrame.extend(/** @lends wp.media.view.MediaFrame.Select.prototype */{
         initialize: function() {
                 // Call 'initialize' directly on the parent class.
                 MediaFrame.prototype.initialize.apply( this, arguments );

src/wp-includes/js/media/views/frame/video-details.js

@@ +1 @@
+var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
+        MediaLibrary = wp.media.controller.MediaLibrary,
+        l10n = wp.media.view.l10n,
+        VideoDetails;
+
 /**
  * wp.media.view.MediaFrame.VideoDetails
  *
+ * @memberOf wp.media.view.MediaFrame
+ *
  * @class
  * @augments wp.media.view.MediaFrame.MediaDetails
  * @augments wp.media.view.MediaFrame.Select
@@ -11 +18 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var MediaDetails = wp.media.view.MediaFrame.MediaDetails,
-        MediaLibrary = wp.media.controller.MediaLibrary,
-        l10n = wp.media.view.l10n,
-        VideoDetails;
-
-VideoDetails = MediaDetails.extend({
+VideoDetails = MediaDetails.extend(/** @lends wp.media.view.MediaFrame.VideoDetails.prototype */{
         defaults: {
                 id:      'video',
                 url:     '',

src/wp-includes/js/media/views/iframe.js

@@ -1 +1 @@
 /**
  * wp.media.view.Iframe
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Iframe = wp.media.View.extend({
+var Iframe = wp.media.View.extend(/** @lends wp.media.view.Iframe.prototype */{
         className: 'media-iframe',
         /**
          * @returns {wp.media.view.Iframe} Returns itself to allow chaining

src/wp-includes/js/media/views/image-details.js

@@ +1 @@
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        $ = jQuery,
+        ImageDetails;
+
 /**
  * wp.media.view.ImageDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -8 +14 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        $ = jQuery,
-        ImageDetails;
-
-ImageDetails = AttachmentDisplay.extend({
+ImageDetails = AttachmentDisplay.extend(/** @lends wp.media.view.ImageDetails.prototype */{
         className: 'image-details',
         template:  wp.template('image-details'),
         events: _.defaults( AttachmentDisplay.prototype.events, {

src/wp-includes/js/media/views/label.js

@@ -1 +1 @@
 /**
  * wp.media.view.Label
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Label = wp.media.View.extend({
+var Label = wp.media.View.extend(/** @lends wp.media.view.Label.prototype */{
         tagName: 'label',
         className: 'screen-reader-text',
 

src/wp-includes/js/media/views/media-details.js

@@ -1 +1 @@
 /* global MediaElementPlayer */
+var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
+        $ = jQuery,
+        MediaDetails;
 
 /**
  * wp.media.view.MediaDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Settings.AttachmentDisplay
  * @augments wp.media.view.Settings
@@ -10 +15 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var AttachmentDisplay = wp.media.view.Settings.AttachmentDisplay,
-        $ = jQuery,
-        MediaDetails;
-
-MediaDetails = AttachmentDisplay.extend({
+MediaDetails = AttachmentDisplay.extend(/** @lends wp.media.view.MediaDetails.prototype */{
         initialize: function() {
                 _.bindAll(this, 'success');
                 this.players = [];
@@ -86 +87 @@
                 this.scriptXhr = false;
         },
 
-        /**
-         * @global MediaElementPlayer
-         */
         setPlayer : function() {
                 var src;
 
@@ -144 +142 @@
         resetFocus: function() {
                 this.$( '.embed-media-settings' ).scrollTop( 0 );
         }
-}, {
+},/** @lends wp.media.view.MediaDetails */{
         instances : 0,
         /**
          * When multiple players in the DOM contain the same src, things get weird.

src/wp-includes/js/media/views/media-frame.js

@@ +1 @@
+var Frame = wp.media.view.Frame,
+        $ = jQuery,
+        MediaFrame;
+
 /**
  * wp.media.view.MediaFrame
  *
  * The frame used to create the media modal.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Frame
  * @augments wp.media.View
@@ -10 +16 @@
  * @augments Backbone.View
  * @mixes wp.media.controller.StateMachine
  */
-var Frame = wp.media.view.Frame,
-        $ = jQuery,
-        MediaFrame;
-
-MediaFrame = Frame.extend({
+MediaFrame = Frame.extend(/** @lends wp.media.view.MediaFrame.prototype */{
         className: 'media-frame',
         template:  wp.template('media-frame'),
         regions:   ['menu','title','content','toolbar','router'],
@@ -24 +26 @@
         },
 
         /**
-         * @global wp.Uploader
+         * @constructs
          */
         initialize: function() {
                 Frame.prototype.initialize.apply( this, arguments );
@@ -232 +234 @@
 // Map some of the modal's methods to the frame.
 _.each(['open','close','attach','detach','escape'], function( method ) {
         /**
+         * @function open
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function close
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function attach
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function detach
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
+         * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
+         */
+        /**
+         * @function escape
+         * @memberOf wp.media.view.MediaFrame
+         * @instance
+         *
          * @returns {wp.media.view.MediaFrame} Returns itself to allow chaining
          */
         MediaFrame.prototype[ method ] = function() {

src/wp-includes/js/media/views/menu-item.js

@@ +1 @@
+var $ = jQuery,
+        MenuItem;
+
 /**
  * wp.media.view.MenuItem
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        MenuItem;
-
-MenuItem = wp.media.View.extend({
+MenuItem = wp.media.View.extend(/** @lends wp.media.view.MenuItem.prototype */{
         tagName:   'a',
         className: 'media-menu-item',
 

src/wp-includes/js/media/views/menu.js

@@ +1 @@
+var MenuItem = wp.media.view.MenuItem,
+        PriorityList = wp.media.view.PriorityList,
+        Menu;
+
 /**
  * wp.media.view.Menu
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.PriorityList
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MenuItem = wp.media.view.MenuItem,
-        PriorityList = wp.media.view.PriorityList,
-        Menu;
-
-Menu = PriorityList.extend({
+Menu = PriorityList.extend(/** @lends wp.media.view.Menu.prototype */{
         tagName:   'div',
         className: 'media-menu',
         property:  'state',

src/wp-includes/js/media/views/modal.js

@@ +1 @@
+var $ = jQuery,
+        Modal;
+
 /**
  * wp.media.view.Modal
  *
  * A modal view, which the media modal uses as its default container.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var $ = jQuery,
-        Modal;
-
-Modal = wp.media.View.extend({
+Modal = wp.media.View.extend(/** @lends wp.media.view.Modal.prototype */{
         tagName:  'div',
         template: wp.template('media-modal'),
 

src/wp-includes/js/media/views/priority-list.js

@@ -1 +1 @@
 /**
  * wp.media.view.PriorityList
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var PriorityList = wp.media.View.extend({
+var PriorityList = wp.media.View.extend(/** @lends wp.media.view.PriorityList.prototype */{
         tagName:   'div',
 
         initialize: function() {

src/wp-includes/js/media/views/router-item.js

@@ -1 +1 @@
 /**
  * wp.media.view.RouterItem
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MenuItem
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var RouterItem = wp.media.view.MenuItem.extend({
+var RouterItem = wp.media.view.MenuItem.extend(/** @lends wp.media.view.RouterItem.prototype */{
         /**
          * On click handler to activate the content region's corresponding mode.
          */

src/wp-includes/js/media/views/router.js

@@ +1 @@
+var Menu = wp.media.view.Menu,
+        Router;
+
 /**
  * wp.media.view.Router
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Menu
  * @augments wp.media.view.PriorityList
@@ -8 +13 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Menu = wp.media.view.Menu,
-        Router;
-
-Router = Menu.extend({
+Router = Menu.extend(/** @lends wp.media.view.Router.prototype */{
         tagName:   'div',
         className: 'media-router',
         property:  'contentMode',

src/wp-includes/js/media/views/search.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        Search;
+
 /**
  * wp.media.view.Search
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Search;
-
-Search = wp.media.View.extend({
+Search = wp.media.View.extend(/** @lends wp.media.view.Search.prototype */{
         tagName:   'input',
         className: 'search',
         id:        'media-search-input',

src/wp-includes/js/media/views/selection.js

@@ +1 @@
+var l10n = wp.media.view.l10n,
+        Selection;
+
 /**
  * wp.media.view.Selection
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var l10n = wp.media.view.l10n,
-        Selection;
-
-Selection = wp.media.View.extend({
+Selection = wp.media.View.extend(/** @lends wp.media.view.Selection.prototype */{
         tagName:   'div',
         className: 'media-selection',
         template:  wp.template('media-selection'),

src/wp-includes/js/media/views/settings.js

@@ +1 @@
+var View = wp.media.View,
+        $ = Backbone.$,
+        Settings;
+
 /**
  * wp.media.view.Settings
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = Backbone.$,
-        Settings;
-
-Settings = View.extend({
+Settings = View.extend(/** @lends wp.media.view.Settings.prototype */{
         events: {
                 'click button':    'updateHandler',
                 'change input':    'updateHandler',

src/wp-includes/js/media/views/settings/attachment-display.js

@@ +1 @@
+var Settings = wp.media.view.Settings,
+        AttachmentDisplay;
+
 /**
  * wp.media.view.Settings.AttachmentDisplay
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Settings = wp.media.view.Settings,
-        AttachmentDisplay;
-
-AttachmentDisplay = Settings.extend({
+AttachmentDisplay = Settings.extend(/** @lends wp.media.view.Settings.AttachmentDisplay.prototype */{
         className: 'attachment-display-settings',
         template:  wp.template('attachment-display-settings'),
 

src/wp-includes/js/media/views/settings/gallery.js

@@ -1 +1 @@
 /**
  * wp.media.view.Settings.Gallery
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Gallery = wp.media.view.Settings.extend({
+var Gallery = wp.media.view.Settings.extend(/** @lends wp.media.view.Settings.Gallery.prototype */{
         className: 'collection-settings gallery-settings',
         template:  wp.template('gallery-settings')
 });

src/wp-includes/js/media/views/settings/playlist.js

@@ -1 +1 @@
 /**
  * wp.media.view.Settings.Playlist
  *
+ * @memberOf wp.media.view.Settings
+ *
  * @class
  * @augments wp.media.view.Settings
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Playlist = wp.media.view.Settings.extend({
+var Playlist = wp.media.view.Settings.extend(/** @lends wp.media.view.Settings.Playlist.prototype */{
         className: 'collection-settings playlist-settings',
         template:  wp.template('playlist-settings')
 });

src/wp-includes/js/media/views/sidebar.js

@@ -1 +1 @@
 /**
  * wp.media.view.Sidebar
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.PriorityList
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Sidebar = wp.media.view.PriorityList.extend({
+var Sidebar = wp.media.view.PriorityList.extend(/** @lends wp.media.view.Sidebar.prototype */{
         className: 'media-sidebar'
 });
 

src/wp-includes/js/media/views/site-icon-cropper.js

@@ +1 @@
+var View = wp.media.view,
+        SiteIconCropper;
+
 /**
  * wp.media.view.SiteIconCropper
  *
@@ -6 +9 @@
  * Takes imgAreaSelect options from
  * wp.customize.SiteIconControl.calculateImageSelectOptions.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.Cropper
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.view,
-        SiteIconCropper;
-
-SiteIconCropper = View.Cropper.extend({
+SiteIconCropper = View.Cropper.extend(/** @lends wp.media.view.SiteIconCropper.prototype */{
         className: 'crop-content site-icon',
 
         ready: function () {

src/wp-includes/js/media/views/site-icon-preview.js

@@ +1 @@
+var View = wp.media.View,
+        $ = jQuery,
+        SiteIconPreview;
+
 /**
  * wp.media.view.SiteIconPreview
  *
  * Shows a preview of the Site Icon as a favicon and app icon while cropping.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        $ = jQuery,
-        SiteIconPreview;
-
-SiteIconPreview = View.extend({
+SiteIconPreview = View.extend(/** @lends wp.media.view.SiteIconPreview.prototype */{
         className: 'site-icon-preview',
         template: wp.template( 'site-icon-preview' ),
 

src/wp-includes/js/media/views/spinner.js

@@ -1 +1 @@
 /**
  * wp.media.view.Spinner
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Spinner = wp.media.View.extend({
+var Spinner = wp.media.View.extend(/** @lends wp.media.view.Spinner.prototype */{
         tagName:   'span',
         className: 'spinner',
         spinnerTimeout: false,

src/wp-includes/js/media/views/toolbar.js

@@ +1 @@
+var View = wp.media.View,
+        Toolbar;
+
 /**
  * wp.media.view.Toolbar
  *
  * A toolbar which consists of a primary and a secondary section. Each sections
  * can be filled with views.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        Toolbar;
-
-Toolbar = View.extend({
+Toolbar = View.extend(/** @lends wp.media.view.Toolbar.prototype */{
         tagName:   'div',
         className: 'media-toolbar',
 

src/wp-includes/js/media/views/toolbar/embed.js

@@ +1 @@
+var Select = wp.media.view.Toolbar.Select,
+        l10n = wp.media.view.l10n,
+        Embed;
+
 /**
  * wp.media.view.Toolbar.Embed
  *
+ * @memberOf wp.media.view.Toolbar
+ *
  * @class
  * @augments wp.media.view.Toolbar.Select
  * @augments wp.media.view.Toolbar
@@ -8 +14 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Select = wp.media.view.Toolbar.Select,
-        l10n = wp.media.view.l10n,
-        Embed;
-
-Embed = Select.extend({
+Embed = Select.extend(/** @lends wp.media.view.Toolbar.Embed.prototype */{
         initialize: function() {
                 _.defaults( this.options, {
                         text: l10n.insertIntoPost,

src/wp-includes/js/media/views/toolbar/select.js

@@ +1 @@
+var Toolbar = wp.media.view.Toolbar,
+        l10n = wp.media.view.l10n,
+        Select;
+
 /**
  * wp.media.view.Toolbar.Select
  *
+ * @memberOf wp.media.view.Toolbar
+ *
  * @class
  * @augments wp.media.view.Toolbar
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var Toolbar = wp.media.view.Toolbar,
-        l10n = wp.media.view.l10n,
-        Select;
-
-Select = Toolbar.extend({
+Select = Toolbar.extend(/** @lends wp.media.view.Toolbar.Select.prototype */{
         initialize: function() {
                 var options = this.options;
 

src/wp-includes/js/media/views/uploader/editor.js

@@ +1 @@
+var View = wp.media.View,
+        l10n = wp.media.view.l10n,
+        $ = jQuery,
+        EditorUploader;
+
 /**
  * Creates a dropzone on WP editor instances (elements with .wp-editor-wrap)
  * and relays drag'n'dropped files to a media workflow.
  *
  * wp.media.view.EditorUploader
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        l10n = wp.media.view.l10n,
-        $ = jQuery,
-        EditorUploader;
-
-EditorUploader = View.extend({
+EditorUploader = View.extend(/** @lends wp.media.view.EditorUploader.prototype */{
         tagName:   'div',
         className: 'uploader-editor',
         template:  wp.template( 'uploader-editor' ),

src/wp-includes/js/media/views/uploader/inline.js

@@ +1 @@
+var View = wp.media.View,
+        UploaderInline;
+
 /**
  * wp.media.view.UploaderInline
  *
  * The inline uploader that shows up in the 'Upload Files' tab.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderInline;
-
-UploaderInline = View.extend({
+UploaderInline = View.extend(/** @lends wp.media.view.UploaderInline.prototype */{
         tagName:   'div',
         className: 'uploader-inline',
         template:  wp.template('uploader-inline'),

src/wp-includes/js/media/views/uploader/status-error.js

@@ -1 +1 @@
 /**
  * wp.media.view.UploaderStatusError
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var UploaderStatusError = wp.media.View.extend({
+var UploaderStatusError = wp.media.View.extend(/** @lends wp.media.view.UploaderStatusError.prototype */{
         className: 'upload-error',
         template:  wp.template('uploader-status-error')
 });

src/wp-includes/js/media/views/uploader/status.js

@@ +1 @@
+var View = wp.media.View,
+        UploaderStatus;
+
 /**
  * wp.media.view.UploaderStatus
  *
  * An uploader status for on-going uploads.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.media.View,
-        UploaderStatus;
-
-UploaderStatus = View.extend({
+UploaderStatus = View.extend(/** @lends wp.media.view.UploaderStatus.prototype */{
         className: 'media-uploader-status',
         template:  wp.template('uploader-status'),
 
@@ -31 +33 @@
                 this.errors.on( 'add', this.error, this );
         },
         /**
-         * @global wp.Uploader
          * @returns {wp.media.view.UploaderStatus}
          */
         dispose: function() {
@@ -117 +118 @@
         },
 
         /**
-         * @global wp.Uploader
-         *
          * @param {Object} event
          */
         dismiss: function( event ) {

src/wp-includes/js/media/views/uploader/window.js

@@ +1 @@
+var $ = jQuery,
+        UploaderWindow;
+
 /**
  * wp.media.view.UploaderWindow
  *
  * An uploader window that allows for dragging and dropping media.
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.View
  * @augments wp.Backbone.View
@@ -14 +19 @@
  * @param {jQuery} [options.uploader.dropzone] jQuery collection of the dropzone.
  * @param {object} [options.uploader.params]
  */
-var $ = jQuery,
-        UploaderWindow;
-
-UploaderWindow = wp.media.View.extend({
+UploaderWindow = wp.media.View.extend(/** @lends wp.media.view.UploaderWindow.prototype */{
         tagName:   'div',
         className: 'uploader-window',
         template:  wp.template('uploader-window'),

src/wp-includes/js/media/views/video-details.js

@@ +1 @@
+var MediaDetails = wp.media.view.MediaDetails,
+        VideoDetails;
+
 /**
  * wp.media.view.VideoDetails
  *
+ * @memberOf wp.media.view
+ *
  * @class
  * @augments wp.media.view.MediaDetails
  * @augments wp.media.view.Settings.AttachmentDisplay
@@ -9 +14 @@
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var MediaDetails = wp.media.view.MediaDetails,
-        VideoDetails;
-
-VideoDetails = MediaDetails.extend({
+VideoDetails = MediaDetails.extend(/** @lends wp.media.view.VideoDetails.prototype */{
         className: 'video-details',
         template:  wp.template('video-details'),
 

src/wp-includes/js/media/views/view.js

@@ -10 +10 @@
  * This behavior has since been removed, and should not be used
  * outside of the media manager.
  *
+ * @memberOf wp.media
+ *
  * @class
  * @augments wp.Backbone.View
  * @augments Backbone.View
  */
-var View = wp.Backbone.View.extend({
+var View = wp.Backbone.View.extend(/** @lends wp.media.View.prototype */{
         constructor: function( options ) {
                 if ( options && options.controller ) {
                         this.controller = options.controller;

src/wp-includes/js/plupload/wp-plupload.js

@@ -198 +198 @@
                 /**
                  * After files were filtered and added to the queue, create a model for each.
                  *
-                 * @event FilesAdded
                  * @param {plupload.Uploader} uploader Uploader instance.
                  * @param {Array}             files    Array of file objects that were added to queue by the user.
                  */
@@ -340 +339 @@
                 }
         };
 
-        $.extend( Uploader.prototype, {
+        $.extend( Uploader.prototype, /** @lends wp.Uploader.prototype */{
                 /**
                  * Acts as a shortcut to extending the uploader's multipart_params object.
                  *

src/wp-includes/js/shortcode.js

@@ -1 +1 @@
 // Utility functions for parsing and handling shortcodes in JavaScript.
 
-// Ensure the global `wp` object exists.
+/**
+ * Ensure the global `wp` object exists.
+ *
+ * @namespace wp
+ */
 window.wp = window.wp || {};
 
 (function(){

src/wp-includes/js/wp-a11y.js

@@ +1 @@
+/** @namespace wp */
 window.wp = window.wp || {};
 
 ( function ( wp, $ ) {
@@ -94 +95 @@
                 }
         });
 
+        /** @namespace wp.a11y */
         wp.a11y = wp.a11y || {};
         wp.a11y.speak = speak;
 

src/wp-includes/js/wp-api.js

@@ -6 +6 @@
          * Initialise the WP_API.
          */
         function WP_API() {
+                /** @namespace wp.api.models */
                 this.models = {};
+                /** @namespace wp.api.collections */
                 this.collections = {};
+                /** @namespace wp.api.views */
                 this.views = {};
         }
 
+        /** @namespace wp */
         window.wp            = window.wp || {};
+        /** @namespace wp.api */
         wp.api               = wp.api || new WP_API();
         wp.api.versionString = wp.api.versionString || 'wp/v2/';
 
@@ -28 +33 @@
 
         var pad, r;
 
+        /** @namespace wp */
         window.wp = window.wp || {};
+        /** @namespace wp.api */
         wp.api = wp.api || {};
+        /** @namespace wp.api.utils */
         wp.api.utils = wp.api.utils || {};
 
         /**
@@ -997 +1005 @@
 
         var Endpoint, initializedDeferreds = {},
                 wpApiSettings = window.wpApiSettings || {};
+
+        /** @namespace wp */
         window.wp = window.wp || {};
+
+        /** @namespace wp.api */
         wp.api    = wp.api || {};
 
         // If wpApiSettings is unavailable, try the default.
@@ -1005 +1017 @@
                 wpApiSettings.root = window.location.origin + '/wp-json/';
         }
 
-        Endpoint = Backbone.Model.extend( {
+        Endpoint = Backbone.Model.extend(/** @lends Endpoint.prototype */{
                 defaults: {
                         apiRoot: wpApiSettings.root,
                         versionString: wp.api.versionString,
@@ -1054 +1066 @@
                                          * When the server returns the schema model data, store the data in a sessionCache so we don't
                                          * have to retrieve it again for this session. Then, construct the models and collections based
                                          * on the schema model data.
+                                         *
+                                         * @callback
                                          */
                                         success: function( newSchemaModel ) {
 

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

@@ +1 @@
+/** @namespace wp */
 window.wp = window.wp || {};
 
 (function ($) {
-        // Create the WordPress Backbone namespace.
+        /**
+         * Create the WordPress Backbone namespace.
+         *
+         * @namespace wp.Backbone
+         */
         wp.Backbone = {};
 
 

src/wp-includes/js/wp-custom-header.js

@@ -3 +3 @@
 
         var NativeHandler, YouTubeHandler;
 
+        /** @namespace wp */
         window.wp = window.wp || {};
 
         // Fail gracefully in unsupported browsers.
@@ -32 +33 @@
         /**
          * Create a custom header instance.
          *
-         * @class CustomHeader
+         * @memberOf wp
+         *
+         * @class
          */
         function CustomHeader() {
                 this.handlers = {
@@ -91 +94 @@
         /**
          * Create a video handler instance.
          *
-         * @class BaseHandler
+         * @memberOf wp
+         *
+         * @class
          */
         function BaseHandler() {}
 
@@ -228 +233 @@
         /**
          * Create a custom handler.
          *
+         * @memberOf wp
+         *
          * @param {object} protoProps Properties to apply to the prototype.
          * @return CustomHandler The subclass.
          */
@@ -252 +259 @@
         /**
          * Native video handler.
          *
-         * @class NativeHandler
+         * @memberOf wp
+         *
+         * @class
          */
-        NativeHandler = BaseHandler.extend({
+        NativeHandler = BaseHandler.extend(/** @lends wp.NativeHandler.prototype */{
                 /**
                  * Whether the native handler supports a video.
                  *
@@ -324 +333 @@
         /**
          * YouTube video handler.
          *
-         * @class YouTubeHandler
+         * @memberOf wp
+         *
+         * @class wp.YouTubeHandler
          */
-        YouTubeHandler = BaseHandler.extend({
+        YouTubeHandler = BaseHandler.extend(/** @lends wp.YouTubeHandler.prototype */{
                 /**
                  * Whether the handler supports a video.
                  *

src/wp-includes/js/wp-embed.js

@@ -19 +19 @@
                         }
                 }
 
+        /** @namespace wp */
         window.wp = window.wp || {};
 
         if ( !! window.wp.receiveEmbedMessage ) {

src/wp-includes/js/wp-pointer.js

@@ -6 +6 @@
         var identifier = 0,
                 zindex = 9999;
 
-        $.widget('wp.pointer', {
+        /**
+         * @class $.widget.wp.pointer
+         */
+        $.widget('wp.pointer',/** @lends $.widget.wp.pointer.prototype */{
                 options: {
                         pointerClass: 'wp-pointer',
                         pointerWidth: 320,

src/wp-includes/js/wp-util.js

@@ -1 +1 @@
 /* global _wpUtilSettings */
+
+/** @namespace wp */
 window.wp = window.wp || {};
 
 (function ($) {