Remove superfluous comments

Author: wooorm

index.js

@@ -1,16 +1,5 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Assert `unist` nodes.
- */
-
 'use strict';
 
-/* eslint-env commonjs */
-/* eslint-disable no-useless-concat */
-
 /* Dependencies. */
 var assert = require('assert');
 var array = require('x-is-array');
@@ -19,6 +8,7 @@ var object = require('x-is-object');
 var inspect;
 
 try {
+  // eslint-disable-next-line import/no-dynamic-require, no-useless-concat
   inspect = require('ut' + 'il').inspect;
 } catch (err) { /* Empty. */ }
 
@@ -36,14 +26,8 @@ var ID = '__unist__';
 /* List of specced properties. */
 var defined = ['type', 'value', 'children', 'position'];
 
-/**
- * Wrapper around `Node` which adds the current node
- * (and parent, if available), to the message.
- *
- * @param {Node} node - Node to checl.
- * @param {Node?} [parent] - Parent of `node`.
- * @throws {Error} - Prettified error.
- */
+/* Wrapper around `Node` which adds the current node
+ * (and parent, if available), to the message. */
 function wrap(fn) {
   return wrapped;
 
@@ -66,13 +50,7 @@ function wrap(fn) {
   }
 }
 
-/**
- * Assert.
- *
- * @param {Node} node - Value to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   unist.
- */
+/* Assert. */
 function unist(node) {
   var type;
   var children;
@@ -114,15 +92,8 @@ function unist(node) {
   }
 }
 
-/**
- * Assert `value` (which lives at `key`) can be stringified
- * and re-parsed to the same (deep) value.
- *
- * @param {*} value - Value to assert.
- * @param {string} key - Property at which `value` lives.
- * @throws {Error} - If the given value doesn’t adhere to
- *   `Parent`.
- */
+/* Assert `value` (which lives at `key`) can be stringified
+ * and re-parsed to the same (deep) value. */
 function vanilla(key, value) {
   try {
     assert.deepEqual(value, JSON.parse(JSON.stringify(value)));
@@ -131,16 +102,9 @@ function vanilla(key, value) {
   }
 }
 
-/**
- * Stringify a value to inspect it.  Tries `JSON.stringify()`,
+/* Stringify a value to inspect it.  Tries `JSON.stringify()`,
  * and if that fails uses `String()` instead.  If `stringify()`
- * works, ``
- *
- * @param {*} value - Value to assert.
- * @param {string} key - Property at which `value` lives.
- * @throws {Error} - If the given value doesn’t adhere to
- *   `Parent`.
- */
+ * works. */
 function view(value) {
   try {
     /* eslint-disable no-else-return */
@@ -156,56 +120,32 @@ function view(value) {
   }
 }
 
-/**
- * Assert `node` is a parent node.
- *
- * @param {Node} node - Value to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   `Parent`.
- */
+/* Assert `node` is a parent node. */
 function parent(node) {
   unist(node);
 
   assert.equal('value' in node, false, 'parent should not have `value`');
   assert.ok('children' in node, 'parent should have `children`');
 }
 
-/**
- * Assert `node` is a text node.
- *
- * @param {Node} node - Value to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   `Text`.
- */
+/* Assert `node` is a text node. */
 function text(node) {
   unist(node);
 
   assert.equal('children' in node, false, 'text should not have `children`');
   assert.ok('value' in node, 'text should have `value`');
 }
 
-/**
- * Assert `node` is a Unist node, but neither parent nor
- * text.
- *
- * @param {Node} node - Value to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   Unist, is a `Parent`, or a `Text`.
- */
+/* Assert `node` is a Unist node, but neither parent nor
+ * text. */
 function empty(node) {
   unist(node);
 
   assert.equal('value' in node, false, 'void should not have `value`');
   assert.equal('children' in node, false, 'void should not have `children`');
 }
 
-/**
- * Assert `location` is a Unist Location.
- *
- * @param {Location} location - Location to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   Unist Location.
- */
+/* Assert `location` is a Unist Location. */
 function location(location) {
   if (location != null) {
     assert.ok(object(location), '`position` should be an object');
@@ -215,13 +155,7 @@ function location(location) {
   }
 }
 
-/**
- * Assert `location` is a Unist Location.
- *
- * @param {Location} location - Location to assert.
- * @throws {Error} - If the given value doesn’t adhere to
- *   Unist Location.
- */
+/* Assert `location` is a Unist Location. */
 function position(position, name) {
   if (position != null) {
     assert.ok(object(position), '`' + name + '` should be an object');

test/children.js

@@ -1,16 +1,5 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
@@ -27,7 +16,7 @@ test('children', function (t) {
     function () {
       assert({type: 'foo', children: ['one']});
     },
-    /^AssertionError: node should be an object: `'one'` in `{ type: 'foo', children: \[ 'one' \] }`$/,
+    /^AssertionError: node should be an object: `'one'` in `{ type: 'foo', children: \[ 'one' ] }`$/,
     'should throw if given a non-node child in children'
   );
 
@@ -45,7 +34,7 @@ test('children', function (t) {
         children: ['one']
       }]});
     },
-    /^AssertionError: node should be an object: `'one'` in `{ type: 'bar', children: \[ 'one' \] }`$/,
+    /^AssertionError: node should be an object: `'one'` in `{ type: 'bar', children: \[ 'one' ] }`$/,
     'should throw on invalid descendants'
   );
 

test/index.js

@@ -1,18 +1,7 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
+/* eslint-disable import/no-unassigned-import */
 
-/* Tests. */
 require('./node');
 require('./type');
 require('./value');

test/node.js

@@ -1,20 +1,8 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
-/* Tests. */
 test('node', function (t) {
   t.throws(
     function () {

test/non-defined.js

@@ -1,20 +1,8 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
-/* Tests. */
 test('non-defined', function (t) {
   t.doesNotThrow(
     function () {
@@ -41,7 +29,7 @@ test('non-defined', function (t) {
         data: {foo: Function}
       });
     },
-    /^AssertionError: non-specced property `data` should be JSON: `{ type: 'break', data: { foo: \[Function: Function\] } }`$/,
+    /^AssertionError: non-specced property `data` should be JSON: `{ type: 'break', data: { foo: \[Function: Function] } }`$/,
     'should throw if non-defined properties are not serialisable'
   );
 

test/parent.js

@@ -1,16 +1,5 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 

test/position.js

@@ -1,20 +1,8 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
-/* Tests. */
 test('position', function (t) {
   t.throws(
     function () {

test/text.js

@@ -1,16 +1,5 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
@@ -27,7 +16,7 @@ test('assert.text()', function (t) {
     function () {
       assert.text({type: 'strong', children: []});
     },
-    /^AssertionError: text should not have `children`: `{ type: 'strong', children: \[\] }`$/,
+    /^AssertionError: text should not have `children`: `{ type: 'strong', children: \[] }`$/,
     'should throw if the given node has `children`'
   );
 

test/type.js

@@ -1,26 +1,14 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 
-/* Tests. */
 test('type', function (t) {
   t.throws(
     function () {
       assert([1, 5]);
     },
-    /^AssertionError: node should have a type: `\[ 1, 5 \]`$/,
+    /^AssertionError: node should have a type: `\[ 1, 5 ]`$/,
     'should throw if not given a `type` (#1)'
   );
 

test/value.js

@@ -1,16 +1,5 @@
-/**
- * @author Titus Wormer
- * @copyright 2016 Titus Wormer
- * @license MIT
- * @module unist-util-assert
- * @fileoverview Test suite for `unist-util-assert`.
- */
-
 'use strict';
 
-/* eslint-env node */
-
-/* Dependencies. */
 var test = require('tape');
 var assert = require('..');
 

test/void.js

@@ -35,7 +35,7 @@ test('assert.void()', function (t) {
     function () {
       assert.void({type: 'strong', children: []});
     },
-    /^AssertionError: void should not have `children`: `{ type: 'strong', children: \[\] }`$/,
+    /^AssertionError: void should not have `children`: `{ type: 'strong', children: \[] }`$/,
     'should throw if the given node has `children`'
   );