Possible implementation of a "local" tag.

plugins_local.js

/**
    @overview Make references to local things local.
    @module plugins/local
    @author Michael Mathews <micmath@gmail.com>
 */
 
var thisModule = '',
    registry = {};

function reset() {
    thisModule = '';
    registry = {};
}

exports.defineTags = function(dictionary) {
    dictionary.defineTag('local', {
        onTagged: function(doclet, tag) {
            registry[tag.text] = true;
        }
    });
}

exports.handlers = {
    jsdocCommentFound: function(e) {
        if (thisModule) for (var local in registry) {
            e.comment = e.comment.replace('{'+local, '{'+thisModule+'~'+local);
        }
    },
    
    newDoclet: function(e) {
        if (e.doclet.kind === 'module') {
            thisModule = e.doclet.longname;
        }
        else {
            if (thisModule) for (var local in registry) {
                var augment;
                if (e.doclet.augments) {
                    for (var i = 0, len = e.doclet.augments.length; i < len; i++) {
                        augment = e.doclet.augments[i];
                        if (augment && augment.indexOf(local) === 0) {
                            e.doclet.augments[i] = thisModule+'~'+e.doclet.augments[i];
                        }
                    }
                }
                
                if (e.doclet.longname.indexOf(local) === 0) {
                    e.doclet.longname = thisModule+'~'+e.doclet.longname;
                }
            }
        }
    },
    fileComplete: function(e) {
        reset();
    }
};

test.js

/**
 * @fileoverview This is a test case.
 * @module test
 * @local BaseClass
 * @local ChildClass
 */

/**
 * This is a base class.
 * @constructor
 */
function BaseClass(x) {
  /** document me */
  this.x = x;
}

/**
 * Gets X.
 * @return {number} The value of X.
 */
BaseClass.prototype.getX = function() {
  return this.x;
};

/**
 * This is a class that inherits from the base class.
 * @constructor
 * @extends {BaseClass}
 */
function ChildClass(x, y) {
  BaseClass.call(this, x);
  this.y = y;
}
ChildClass.prototype = Object.create(BaseClass.prototype);
ChildClass.prototype.constructor = ChildClass;

/**
 * Returns a copy of this ChildClass.
 * @return {ChildClass} The copy.
 */
ChildClass.prototype.copy = function() {
  return new ChildClass(this.x, this.y);
};