diff --git a/lib/indexer/addrindexer.js b/lib/indexer/addrindexer.js
index cdcd78dd..ce2478dd 100644
--- a/lib/indexer/addrindexer.js
+++ b/lib/indexer/addrindexer.js
@@ -1,5 +1,5 @@
 /*!
- * addrindexer.js - addr indexer
+ * addrindexer.js - address indexer for bcoin
  * Copyright (c) 2018, the bcoin developers (MIT License).
  * https://github.com/bcoin-org/bcoin
  */
diff --git a/lib/indexer/indexer.js b/lib/indexer/indexer.js
index 0628a641..33f45de9 100644
--- a/lib/indexer/indexer.js
+++ b/lib/indexer/indexer.js
@@ -1,5 +1,5 @@
 /*!
- * indexer.js - storage for indexes
+ * indexer.js - abstract interface for bcoin indexers
  * Copyright (c) 2018, the bcoin developers (MIT License).
  * https://github.com/bcoin-org/bcoin
  */
@@ -21,11 +21,12 @@ const {ZERO_HASH} = require('../protocol/consensus');
 
 /**
  * Indexer
+ * The class which indexers inherit from and implement the
+ * `indexBlock` and `unindexBlock` methods and database
+ * and storage initialization for indexing blocks.
  * @alias module:indexer.Indexer
  * @extends EventEmitter
- * @property {IndexerDB} db
- * @property {Number} height
- * @emits Indexer#chain tip
+ * @abstract
  */
 
 class Indexer extends EventEmitter {
@@ -121,7 +122,7 @@ class Indexer extends EventEmitter {
   }
 
   /**
-   * Close the indexdb, wait for the database to close.
+   * Close the indexer, wait for the database to close.
    * @returns {Promise}
    */
 
diff --git a/lib/indexer/txindexer.js b/lib/indexer/txindexer.js
index 64a5f3ac..ff8c5568 100644
--- a/lib/indexer/txindexer.js
+++ b/lib/indexer/txindexer.js
@@ -1,5 +1,5 @@
 /*!
- * txindexer.js - tx indexer
+ * txindexer.js - transaction indexer for bcoin
  * Copyright (c) 2018, the bcoin developers (MIT License).
  * https://github.com/bcoin-org/bcoin
  */