Add @ignore support

Author: jfirebaugh

lib/filter_access.js

@@ -15,7 +15,7 @@ function filterAccess(levels, comments) {
   levels = levels || ['public', 'undefined', 'protected'];
 
   function filter(comment) {
-    return levels.indexOf(String(comment.access)) !== -1;
+    return !comment.ignore && levels.indexOf(String(comment.access)) !== -1;
   }
 
   function recurse(comment) {

lib/parse.js

@@ -70,7 +70,7 @@ var flatteners = {
     result.scope = 'global';
   },
   'host': synonym('external'),
-  // 'ignore'
+  'ignore': flattenBoolean,
   // 'implements'
   // 'inheritdoc'
   'inner': function (result) {

test/lib/filter_access.js

@@ -3,6 +3,14 @@
 var test = require('tap').test,
   filterAccess = require('../../lib/filter_access');
 
+test('filterAccess ignore', function (t) {
+  t.deepEqual(filterAccess(['public', 'protected', 'undefined'], [{
+    access: 'public',
+    ignore: true
+  }]), []);
+  t.end();
+});
+
 test('filterAccess public, protected, undefined, no private', function (t) {
   t.deepEqual(filterAccess(['public', 'protected', 'undefined'], [{
     access: 'public'

test/lib/parse.js

@@ -238,6 +238,14 @@ test('parse - @host', function (t) {
   t.end();
 });
 
+test('parse - @ignore', function (t) {
+  t.equal(evaluate(function () {
+    /** @ignore */
+  })[0].ignore, true);
+
+  t.end();
+});
+
 test('parse - @inner', function (t) {
   t.equal(evaluate(function () {
     /** @inner*/