mirror of
https://github.com/documentationjs/documentation.git
synced 2026-01-18 14:17:30 +00:00
c24a9b88a4
Also: * Moves reduction out of parsers so that they don't have awkward function signatures
22 lines
749 B
JavaScript
22 lines
749 B
JavaScript
'use strict';
|
|
|
|
var format = require('util').format;
|
|
var path = require('path');
|
|
|
|
/**
|
|
* Format an error message regarding a comment, prefixed with file name and line number.
|
|
*
|
|
* @param {Tag|null} tag location in a javascript file, if any
|
|
* @param {Comment} comment a parsed comment
|
|
* @param {string} error error message a string
|
|
* @param {...*} varags format arguments
|
|
* @returns {undefined} outputs to stderr
|
|
*/
|
|
module.exports = function (tag, comment, error) {
|
|
var relativePath = path.relative(process.cwd(), comment.context.file),
|
|
lineNumber = (tag ? tag.lineNumber : 0) + comment.loc.start.line;
|
|
|
|
return format.apply(format, ['%s:%d: ' + error, relativePath, lineNumber]
|
|
.concat(Array.prototype.slice.call(arguments, 3)));
|
|
};
|