Remove superfluous comments

wooorm · wooorm · commit 3d4fc1760bbf · 2017-05-13T12:18:13.000+02:00
diff --git a/index.js b/index.js
@@ -1,17 +1,14 @@
 'use strict';
 
-/* Dependencies. */
 var xtend = require('xtend');
 var toH = require('hast-to-hyperscript');
 var NS = require('web-namespaces');
 var has = require('has');
 var zwitch = require('zwitch');
 var mapz = require('mapz');
 
-/* Expose. */
 module.exports = transform;
 
-/* Construct. */
 var one = zwitch('type');
 var all = mapz(one, {key: 'children', indices: false});
 
@@ -43,22 +40,11 @@ var attributeSpaces = {
   'xmlns:xlink': {prefix: 'xmlns', name: 'xlink', namespace: NS.xmlns}
 };
 
-/**
- * Transform a tree from HAST to Parse5’s AST.
- *
- * @param {HASTNode} tree - HAST tree.
- * @return {ASTNode} - Parse5 tree.
- */
+/* Transform a tree from HAST to Parse5’s AST. */
 function transform(tree) {
   return patch(one(tree), null, NS.html);
 }
 
-/**
- * Transform a root from HAST to Parse5.
- *
- * @param {HASTRoot} node - HAST root.
- * @return {ASTNode.<Document>} - Parse5 document.
- */
 function root(node) {
   var data = node.data || {};
   var qs = has(data, 'quirksMode') ? Boolean(data.quirksMode) : false;
@@ -70,12 +56,6 @@ function root(node) {
   };
 }
 
-/**
- * Transform an element from HAST to Parse5.
- *
- * @param {HASTElement} node - HAST element.
- * @return {ASTNode.<Element>} - Parse5 element.
- */
 function element(node) {
   var shallow = xtend(node);
 
@@ -108,12 +88,6 @@ function element(node) {
   }, shallow);
 }
 
-/**
- * Transform a doctype from HAST to Parse5.
- *
- * @param {HASTDoctype} node - HAST doctype.
- * @return {ASTNode.<DocumentType>} - Parse5 doctype.
- */
 function doctype(node) {
   return wrap(node, {
     nodeName: '#documentType',
@@ -123,39 +97,21 @@ function doctype(node) {
   });
 }
 
-/**
- * Transform a text from HAST to Parse5.
- *
- * @param {HASTText} node - HAST text.
- * @return {ASTNode.<Text>} - Parse5 text.
- */
 function text(node) {
   return wrap(node, {
     nodeName: '#text',
     value: node.value
   });
 }
 
-/**
- * Transform a comment from HAST to Parse5.
- *
- * @param {HASTComment} node - HAST comment.
- * @return {ASTNode.<Comment>} - Parse5 comment.
- */
 function comment(node) {
   return wrap(node, {
     nodeName: '#comment',
     data: node.value
   });
 }
 
-/**
- * Patch position.
- *
- * @param {HASTNode} node - HAST node.
- * @param {ASTNode} node - Parse5 node.
- * @return {ASTNode} - Given Parse5 node.
- */
+/* Patch position. */
 function wrap(node, ast) {
   if (node.position && node.position.start && node.position.end) {
     ast.__location = {
@@ -169,15 +125,8 @@ function wrap(node, ast) {
   return ast;
 }
 
-/**
- * Patch a tree recursively, by adding namespaces
- * and parent references where needed.
- *
- * @param {ASTNode} node - Parse5 node.
- * @param {ASTNode} parent - Parent of `node`.
- * @param {string} ns - Current namespace.
- * @return {ASTNode} - Patched replacement for `node`.
- */
+/* Patch a tree recursively, by adding namespaces
+ * and parent references where needed. */
 function patch(node, parent, ns) {
   var location = node.__location;
   var children = node.childNodes;
diff --git a/test/comment.js b/test/comment.js
@@ -1,11 +1,9 @@
 'use strict';
 
-/* Dependencies. */
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('comment', function (t) {
   var node = parse5.parseFragment('<!--Alpha-->');
 
diff --git a/test/doctype.js b/test/doctype.js
@@ -1,11 +1,9 @@
 'use strict';
 
-/* Dependencies. */
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('doctype', function (t) {
   var node = parse5.parse('<!DOCTYPE html SYSTEM "http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd">');
 
diff --git a/test/element.js b/test/element.js
@@ -1,12 +1,10 @@
 'use strict';
 
-/* Dependencies. */
 var inspect = require('util').inspect;
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('element', function (t) {
   var node = parse5.parseFragment('<h1>Alpha');
 
diff --git a/test/index.js b/test/index.js
@@ -2,7 +2,6 @@
 
 /* eslint-disable import/no-unassigned-import */
 
-/* Tests. */
 require('./root');
 require('./doctype');
 require('./text');
diff --git a/test/position.js b/test/position.js
@@ -1,12 +1,10 @@
 'use strict';
 
-/* Dependencies. */
 var inspect = require('util').inspect;
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('position', function (t) {
   var node = parse5.parseFragment('<h1>Alpha', {locationInfo: true});
 
diff --git a/test/root.js b/test/root.js
@@ -1,11 +1,9 @@
 'use strict';
 
-/* Dependencies. */
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('root', function (t) {
   var ast = parse5.parse('');
 
diff --git a/test/text.js b/test/text.js
@@ -1,11 +1,9 @@
 'use strict';
 
-/* Dependencies. */
 var test = require('tape');
 var parse5 = require('parse5');
 var toParse5 = require('..');
 
-/* Tests. */
 test('text', function (t) {
   var node = parse5.parseFragment('Alpha');
 
