docs: generate docs

Author: brettz9

README.md

@@ -4198,16 +4198,25 @@ Requires all types to be valid JSDoc or Closure compiler types without syntax er
 
 Also impacts behaviors on namepath (or event)-defining and pointing tags:
 
-1. Name(path)-defining tags: `@class`, `@constructor`, `@constant`, `@const`, `@external`, `@host`, `@function`, `@func`, `@method`, `@interface`, `@member`, `@var`, `@mixin`, `@name`, `@namespace`, `@typedef`
-1. Name(path)-pointing tags: `@alias`, `@augments`, `@extends`, `@lends`, `@memberof`, `@memberof!`, `@mixes`, `@this`
-1. Name(path)-defining tags (which may have value without namepath): `@callback`, `@event`
-1. Name(path)-pointing tags (which may have value without namepath): `@listens`, `@fires`, `@emits`
+1. Name(path)-defining tags requiring namepath: `@external`, `@host`, `@name`, `@typedef`
+1. Name(path)-defining tags (which may have value without namepath or their
+    namepath can be expressed elsewhere on the block): `@event`, `@callback`,
+    `@class`, `@constructor`, `@constant`, `@const`,
+    `@function`, `@func`, `@method`, `@interface`, `@member`, `@var`,
+    `@mixin`, `@namespace`
+1. Name(path)-pointing tags requiring namepath: `@alias`, `@augments`, `@extends`, `@lends`, `@memberof`, `@memberof!`, `@mixes`, `@this`
+1. Name(path)-pointing tags (which may have value without namepath or their
+    namepath can be expressed elsewhere on the block): `@listens`, `@fires`,
+    `@emits`
 1. Name(path)-pointing tags (multiple names in one): `@borrows`
 
 ...with the following applying to the above sets:
 
 - Expect tags in set 1-4 to have a valid namepath if present
-- Prevent sets 3-4 from being empty by setting `allowEmptyNamepaths` to `false` as these tags might have some indicative value without a path (but sets 1-2 will always fail if empty)
+- Prevent sets 2 and 4 from being empty by setting `allowEmptyNamepaths` to
+  `false` as these tags might have some indicative value without a path
+  or may allow a name expressed elsewhere on the block (but sets 1 and 3 will
+  always fail if empty)
 - For the special case of set 5, i.e., `@borrows <that namepath> as <this namepath>`, check that both namepaths are present and valid and ensure there is an `as ` between them.
 
 |||
@@ -4319,7 +4328,7 @@ function quux() {
 }
 
 /**
- * @alias module:svgcanvas.SvgCanvas#event:ext_langReady
+ * @alias module:namespace.SomeClass#event:ext_anevent
  */
 function quux() {
 
@@ -4332,11 +4341,26 @@ function quux() {
 
 }
 
+/**
+ * @class
+ */
+function quux() {
+
+}
+
 /**
  * @see {@link foo}
  */
 function quux() {
 
+}
+
+/**
+ *
+ * @fires {module:namespace.SomeClass#event:ext_anevent}
+ */
+function quux() {
+
 }
 ````