mirror of
https://github.com/jsdoc/jsdoc.git
synced 2025-12-08 19:46:11 +00:00
aa0b6c1bfa
With help from Lebab, plus a lot of manual cleanup. (And more cleanup to come, I'm sure.)
22 lines
562 B
JavaScript
22 lines
562 B
JavaScript
/* eslint-disable spaced-comment */
|
|
/**
|
|
* Demonstrate how to modify the source code before the parser sees it.
|
|
*
|
|
* @module plugins/commentConvert
|
|
*/
|
|
exports.handlers = {
|
|
///
|
|
/// Convert ///-style comments into jsdoc comments.
|
|
/// @param e
|
|
/// @param e.filename
|
|
/// @param e.source
|
|
///
|
|
beforeParse(e) {
|
|
e.source = e.source.replace(/(\n[ \t]*\/\/\/[^\n]*)+/g, $ => {
|
|
const replacement = `\n/**${$.replace(/^[ \t]*\/\/\//mg, '').replace(/(\n$|$)/, '*/$1')}`;
|
|
|
|
return replacement;
|
|
});
|
|
}
|
|
};
|