mirror of
https://github.com/documentationjs/documentation.git
synced 2026-01-18 14:17:30 +00:00
19 lines
644 B
JavaScript
19 lines
644 B
JavaScript
'use strict';
|
|
|
|
/**
|
|
* Detect whether a comment is a JSDoc comment: it must be a block
|
|
* comment which starts with two asterisks, not any other number of asterisks.
|
|
*
|
|
* The code parser automatically strips out the first asterisk that's
|
|
* required for the comment to be a comment at all, so we count the remaining
|
|
* comments.
|
|
*
|
|
* @name isJSDocComment
|
|
* @param {Object} comment an ast-types node of the comment
|
|
* @return {boolean} whether it is valid
|
|
*/
|
|
module.exports = function isJSDocComment(comment) {
|
|
var asterisks = comment.value.match(/^(\*+)/);
|
|
return comment.type === 'Block' && asterisks && asterisks[ 1 ].length === 1;
|
|
};
|