Merge pull request #4568 from Polymer/jsdoc-new-tags

Jsdoc new tags

lib/elements/array-selector.html

@@ -30,13 +30,14 @@
    * representing the last selected item.  When `multi` is true, `selected`
    * is an array of multiply selected items.
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    */
   let ArraySelectorMixin = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_ArraySelectorMixin}
      */
     class ArraySelectorMixin extends superClass {
@@ -390,9 +391,10 @@
    * });
    * ```
    *
-   * @polymerElement
+   * @customElement
+   * @polymer
    * @extends Polymer.Element
-   * @mixes Polymer.ArraySelectorMixin
+   * @appliesMixin Polymer.ArraySelectorMixin
    * @memberof Polymer
    * @summary Custom element that links paths between an input `items` array and
    *   an output `selected` item or array based on calls to its selection API.

lib/elements/dom-bind.html

@@ -41,7 +41,7 @@
      * binding scope.
      *
      * @extends HTMLElement
-     * @mixes Polymer.PropertyEffects
+     * @appliesMixin Polymer.PropertyEffects
      * @memberof Polymer
      * @summary Custom element to allow using Polymer's template features (data
      *   binding, declarative event listeners, etc.) in the main document.

lib/elements/dom-if.html

@@ -33,7 +33,8 @@
    * Set the `restamp` property to true to force the stamped content to be
    * created / destroyed when the `if` condition changes.
    *
-   * @polymerElement
+   * @customElement
+   * @polymer
    * @extends Polymer.Element
    * @memberof Polymer
    * @summary Custom element that conditionally stamps and hides or removes

lib/elements/dom-repeat.html

@@ -112,10 +112,11 @@
    *           filter="isEngineer" observe="type manager.type">
    * ```
    *
-   * @polymerElement
+   * @customElement
+   * @polymer
    * @memberof Polymer
    * @extends Polymer.Element
-   * @mixes Polymer.MutableData
+   * @appliesMixin Polymer.MutableData
    * @summary Custom element for stamping instance of a template bound to
    *   items in an array.
    */

lib/legacy/legacy-element-mixin.html

@@ -30,9 +30,10 @@
    * found on the Polymer 1.x `Polymer.Base` prototype applied to all elements
    * defined using the `Polymer({...})` function.
    *
-   * @polymerMixin
-   * @mixes Polymer.ElementMixin
-   * @mixes Polymer.GestureEventListeners
+   * @mixinFunction
+   * @polymer
+   * @appliesMixin Polymer.ElementMixin
+   * @appliesMixin Polymer.GestureEventListeners
    * @property isAttached {boolean} Set to `true` in this element's
    *   `connectedCallback` and `false` in `disconnectedCallback`
    * @memberof Polymer
@@ -60,7 +61,7 @@
     };
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_LegacyElement}
      */
     class LegacyElement extends legacyElementBase {

lib/mixins/element-mixin.html

@@ -102,8 +102,9 @@
    *   `observedAttributes` implementation will automatically return an array
    *   of dash-cased attributes based on `properties`)
    *
-   * @polymerMixin
-   * @mixes Polymer.PropertyEffects
+   * @mixinFunction
+   * @polymer
+   * @appliesMixin Polymer.PropertyEffects
    * @memberof Polymer
    * @property rootPath {string} Set to the value of `Polymer.rootPath`,
    *   which defaults to the main document path
@@ -453,7 +454,7 @@
     }
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @unrestricted
      * @implements {Polymer_ElementMixin}
      */

lib/mixins/gesture-event-listeners.html

@@ -27,15 +27,16 @@
    * templates will support gesture events when this mixin is applied along with
    * `Polymer.TemplateStamp`.
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    * @summary Element class mixin that provides API for adding Polymer's cross-platform
    * gesture events to nodes
    */
   Polymer.GestureEventListeners = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_GestureEventListeners}
      */
     class GestureEventListeners extends superClass {

lib/mixins/mutable-data.html

@@ -65,15 +65,16 @@
    * will be worse as opposed to using strict dirty checking with immutable
    * patterns or Polymer's path notification API.
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    * @summary Element class mixin to skip strict dirty-checking for objects
    *   and arrays
    */
   Polymer.MutableData = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_MutableData}
      */
     class MutableData extends superClass {
@@ -136,15 +137,16 @@
    * strict dirty checking with immutable patterns or Polymer's path notification
    * API.
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    * @summary Element class mixin to optionally skip strict dirty-checking
    *   for objects and arrays
    */
   Polymer.OptionalMutableData = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_OptionalMutableData}
      */
     class OptionalMutableData extends superClass {

lib/mixins/property-accessors.html

@@ -86,15 +86,16 @@
    * deserialized via `attributeChangedCallback` and set to the associated
    * property using `dash-case`-to-`camelCase` convention.
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    * @summary Element class mixin for reacting to property changes from
    *   generated property accessors.
    */
   Polymer.PropertyAccessors = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_PropertyAccessors}
      * @unrestricted
      */

lib/mixins/property-effects.html

@@ -1050,9 +1050,10 @@
    * whereas the default when using `PropertyAccessors` standalone is to be
    * async by default.
    *
-   * @polymerMixin
-   * @mixes Polymer.TemplateStamp
-   * @mixes Polymer.PropertyAccessors
+   * @mixinFunction
+   * @polymer
+   * @appliesMixin Polymer.TemplateStamp
+   * @appliesMixin Polymer.PropertyAccessors
    * @memberof Polymer
    * @summary Element class mixin that provides meta-programming for Polymer's
    * template binding and data observation system.
@@ -1068,7 +1069,7 @@
     const propertyEffectsBase = Polymer.TemplateStamp(Polymer.PropertyAccessors(superClass));
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @unrestricted
      * @implements {Polymer_PropertyEffects}
      */

lib/mixins/template-stamp.html

@@ -106,14 +106,15 @@
    * - Nested template content caching/removal and re-installation (performance
    *   optimization)
    *
-   * @polymerMixin
+   * @mixinFunction
+   * @polymer
    * @memberof Polymer
    * @summary Element class mixin that provides basic template parsing and stamping
    */
   Polymer.TemplateStamp = Polymer.dedupingMixin(superClass => {
 
     /**
-     * @polymerMixinClass
+     * @mixinClass
      * @implements {Polymer_TemplateStamp}
      */
     class TemplateStamp extends superClass {

polymer-element.html

@@ -17,12 +17,13 @@
    * features including template stamping, data-binding, attribute deserialization,
    * and property change observation.
    *
-   * @polymerElement
+   * @customElement
+   * @polymer
    * @memberof Polymer
    * @constructor
    * @implements {Polymer_ElementMixin}
    * @extends HTMLElement
-   * @mixes Polymer.ElementMixin
+   * @appliesMixin Polymer.ElementMixin
    * @summary Custom element base class that provides the core API for Polymer's
    *   key meta-programming features including template stamping, data-binding,
    *   attribute deserialization, and property change observation