add.js

/**
 * Used to set scope to add to classes or methods in another file.
 * Examples:
 * @codestart no-highlight
 * /* @add steal.String Static *|         adds to steal.String's static methods
 * /* @add steal.Controller Prototype *|  adds to steal.Controller's prototype methods
 * @codeend
 * It's important to note that add must be in its own comment block.
 */
DocumentJS.Pair.extend('DocumentJS.Add',
{
    comment_setup: DocumentJS.Function.prototype.comment_setup,
    /**
     * Looks for a line like @add (scope) (Static|Prototype)
     * @param {String} line the line that had @add
     */
    add_add : function(line){
        var m = line.match(/^@add\s+([\w\.]+)\s*([\w\.]+)?/i)
        if(m){
            var sub = m.pop()
            this.sub_scope = sub ? sub.toLowerCase() : null;
            this.scope_name = m.pop()
        }
    },
    /**
     * Searches for the new scope.
     * @return {DocumentJS.Pair} The new scope where additional comments will be added
     */
    scope : function(){
 
        var Class = DocumentJS.Class
        
        //find
        var inst;
        for(var l =0 ; l < Class.listing.length; l++){
            if(Class.listing[l].name == this.scope_name) {
                inst = Class.listing[l];break;
            }
        }
        if(!inst){
            var Class =  DocumentJS.Constructor
            for(var l =0 ; l < Class.listing.length; l++){
                if(Class.listing[l].name == this.scope_name) {
                    inst = Class.listing[l];break;
                }
            }
        }
		if(!inst){
            var Class =  DocumentJS.Page
            for(var l =0 ; l < Class.listing.length; l++){
                if(Class.listing[l].name == this.scope_name) {
                    inst = Class.listing[l];break;
                }
            }
        }
        if(!inst) return this;
        if(this.sub_scope){
            var children = inst.children;
            var child;
            for(var i=0; i< children.length; i++){
                if(children[i].Class.shortName.toLowerCase() == this.sub_scope.toLowerCase()) {
                    child = children[i];break;
                }
            }
            if(child) return child;
        }
        return inst;
        
    },
    toHTML: function(){return ""},
    linker: function(){}
});