Merge pull request #10850 from ahocevar/enum-docs

API docs for enums

config/jsdoc/api/plugins/api.js

@@ -73,9 +73,6 @@ function includeAugments(doclet) {
           });
         }
         cls._hideConstructor = true;
-        if (!cls.undocumented) {
-          cls._documented = true;
-        }
       }
     }
   }
@@ -182,13 +179,14 @@ exports.handlers = {
         doclet._hideConstructor = true;
         includeAugments(doclet);
         sortOtherMembers(doclet);
-      } else if (!doclet._hideConstructor
+      } else if (!doclet._hideConstructor) {
-          && !(doclet.longname in defaultExports && byLongname[doclet.longname].some(d => d.isEnum))) {
         // Remove all other undocumented symbols
         doclet.undocumented = true;
       }
-      if (doclet._documented) {
+      if (doclet.memberof && byLongname[doclet.memberof] &&
-        delete doclet.undocumented;
+          byLongname[doclet.memberof][0].isEnum &&
+          !byLongname[doclet.memberof][0].properties.some(p => p.stability)) {
+        byLongname[doclet.memberof][0].undocumented = true;
       }
     }
   },

config/jsdoc/api/template/tmpl/method.tmpl

@@ -64,7 +64,7 @@ var self = this;
     <ul><?js fires.forEach(function(f) {
             var parts = f.split(/#?event:/);
             var type = parts.pop();
-            var eventClassName = parts[0];
+            var eventClass = self.find({longname: parts[0]})[0];
             parts = type.split(' ');
             type = parts.shift();
             var description = parts.length ? parts.join(' ') : '';
@@ -74,12 +74,9 @@ var self = this;
             }
         ?>
         <li class="<?js= (eventDoclet || data).stability !== 'stable' ? 'unstable' : '' ?>">
-            <code><?js= eventClassName ? self.linkto(f, type) : type ?></code>
+            <code><?js= eventClass ? self.linkto(f, type) : type ?></code>
-            <?js if (eventClassName) {
+            <?js if (eventClass) { ?>
-              var eventClass = self.find({longname: eventClassName})[0];
+              (<?js= self.linkto(eventClass.longname) ?>)
-              if (eventClass) { ?>
-                (<?js= self.linkto(eventClass.longname) ?>)
-              <?js } ?>
             <?js } ?>
             <?js= self.partial('stability.tmpl', eventDoclet || (data.stability ? data : {})) ?>
             <?js if (description) { ?> -

src/ol/style/IconAnchorUnits.js

@@ -7,6 +7,14 @@
  * @enum {string}
  */
 export default {
+  /**
+   * Anchor is a fraction
+   * @api
+   */
   FRACTION: 'fraction',
+  /**
+   * Anchor is in pixels
+   * @api
+   */
   PIXELS: 'pixels'
 };

src/ol/style/IconOrigin.js

@@ -7,8 +7,24 @@
  * @enum {string}
  */
 export default {
+  /**
+   * Origin is at bottom left
+   * @api
+   */
   BOTTOM_LEFT: 'bottom-left',
+  /**
+   * Origin is at bottom right
+   * @api
+   */
   BOTTOM_RIGHT: 'bottom-right',
+  /**
+   * Origin is at top left
+   * @api
+   */
   TOP_LEFT: 'top-left',
+  /**
+   * Origin is at top right
+   * @api
+   */
   TOP_RIGHT: 'top-right'
 };