phaser/v2/tasks/jsdoc-plugins/sourceproxy.js

/**
* Moves information from custom `@sourcepath`, `@sourceline`, `@nosource` doclets
* into the doclet meta-information.
*
* This is useful to maintain source file/lineno links with the YUIDoc-to-JSDoc output.
*/

var path = require('path');

exports.defineTags = function(dictionary) {

    dictionary.defineTag('nosource', {
        onTagged: function (doclet, tag) {
            doclet.meta.nosource = true;
            //doclet.meta.path = '';
            //doclet.meta.filename = '';
        }
    });

    dictionary.defineTag('sourcefile', {
        onTagged: function (doclet, tag) {
            var filename = tag.value;
            doclet.meta.path = path.dirname(filename);
            doclet.meta.filename = path.basename(filename);
        }
    });

    dictionary.defineTag('sourceline', {
       onTagged: function (doclet, tag) {
           var lineno = tag.value;
           doclet.meta.lineno = lineno;
       }
    });

};