Changeset 41351 for trunk/src/wp-includes/js/media/views/toolbar/select.js

Timestamp:

09/08/2017 06:41:20 PM (8 years ago)

Author:

adamsilverstein

Message:

Docs: JSDoc improvements for namespaces.

Improve JS parsing of our inline JSDocs by introducing @namespace, @lends and @memberOf. Helps set the way for showing our JavaScript documentation on developer.wordpress.org, see ​https://meta.trac.wordpress.org/ticket/3063.

• Define all used namespaces using @namespace.
• Correctly specify in which namespace each class is using @memberOf.
• Define each usage of the extend function as a prototype assignment using @lends.
• Some comment blocks were moved to correct the parsing of certain definitions.

Props herregroen, atimmer, netweb, SergeyBiryukov.  
Fixes #41682.

File:

• trunk/src/wp-includes/js/media/views/toolbar/select.js (modified) (2 diffs)

trunk/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
@@ -8 +14 @@
  * @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;