Added initial support for @alias tag. Added test for @module tag.

main.js

@@ -158,7 +158,7 @@ function main() {
         require('jsdoc/src/handlers').attachTo(app.jsdoc.parser);
 
         docs = app.jsdoc.parser.parse(sourceFiles, env.opts.encoding);
-
+//dump(docs); exit(0);
         if (env.opts.expel) {
             dump(docs);
             exit(0);

modules/jsdoc/src/handlers.js

@@ -25,8 +25,11 @@
                 newDoclet = new jsdoc.doclet.Doclet(e.comment, e);
             } 
 
-            // we need to get the symbol name from code
-            if (e.code && e.code.name) {
+            if (newDoclet.alias) {
+                newDoclet.addTag('name', newDoclet.alias);
+                newDoclet.postProcess();
+            }
+            else if (e.code && e.code.name) { // we need to get the symbol name from code
                 newDoclet.addTag('name', e.code.name);
 
                 if (!newDoclet.memberof && e.astnode) {

modules/jsdoc/tag/dictionary/definitions.js

@@ -128,6 +128,15 @@
             mustHaveValue: true
         });
 
+        dictionary.defineTag('alias', {
+            mustHaveValue: true,
+            onTagged: function(doclet, tag) {
+                doclet.alias = tag.value;
+
+                return true;
+            }
+        });
+
         dictionary.defineTag('memberof', {
             mustHaveValue: true,
             onTagged: function(doclet, tag) {
@@ -151,6 +160,8 @@
             onTagged: function(doclet, tag) {
                 setDocletKindToTitle(doclet, tag);
                 setDocletNameToValue(doclet, tag);
+                doclet.name || setDocletNameToFilename(doclet, tag);
+
                 applyNamespace(doclet, tag);
 
                 return false;
@@ -291,6 +302,19 @@
 	    doclet.name = app.jsdoc.name.applyNamespace(doclet.name, tag.title)
 	}
 
+	function setDocletNameToFilename(doclet, tag) {
+	    var name = doclet.meta.filename;
+	    name = name.replace(/\.js$/i, '');
+
+	    for (var i = 0, len = env.opts._.length; i < len; i++) {
+	        if (name.indexOf(env.opts._[i]) === 0) {
+	            name = name.replace(env.opts._[0], '');
+	            break
+	        }
+	    }
+	    doclet.name = name;
+	}
+
 	function parseBorrows(doclet, tag) {
 	    var m = /^(\S+)(?:\s+as\s+(\S+))?$/.exec(tag.text);
 	    if (m) {

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "jsdoc",
 	"version": "3.0.0alpha1",
-	"revision": "2011-01-08-2149",
+	"revision": "2011-01-13-0045",
 	"description": "An automatic documentation generator for javascript.",
 	"keywords": [ "documentation", "javascript" ],
 	"licenses": [

test/cases/alias.js

@@ -0,0 +1,13 @@
+var myObject = (function() {
+
+    /** Give x another name.
+        @alias myObject
+        @namespace 
+     */
+    var x = {
+        /** document me */
+        myProperty: 'foo'
+    }
+
+    return x;
+})();

test/cases/modules/data/mod-1.js

@@ -0,0 +1,5 @@
+/** @module */
+define({
+    property: "foo",
+    method: function() {}
+});

test/cases/modules/data/mod-2.js

@@ -0,0 +1,5 @@
+/** @module my/module/name */
+define({
+    property: "foo",
+    method: function() {}
+});

test/cases/modules/data/mod-3.js

@@ -0,0 +1,21 @@
+/**
+    My test module.
+    @module my/module
+ */
+define(function() {
+
+    /**
+        @undocumented
+        @alias module:my/module
+     */
+    var mod = {
+
+        /** Document a property. */
+        myProperty: "foo",
+
+        /** Document a method. */
+        myMethod: function() {}
+    };
+
+    return mod;
+});

test/runner.js

@@ -83,5 +83,10 @@ testFile('test/t/cases/var.js');
 
 testFile('test/t/cases/inner.js');
 
+testFile('test/t/cases/modules/data/mod-1.js');
+testFile('test/t/cases/modules/data/mod-2.js');
+
+testFile('test/t/cases/alias.js');
+
 report();
 

test/t/cases/alias.js

@@ -0,0 +1,20 @@
+(function() {
+    var docSet = testhelpers.getDocSetFromFile('test/cases/alias.js'),
+        found = docSet.getByLongname('myObject').filter(function($) {
+            return ! $.undocumented;
+        }),
+
+        foundMember = docSet.getByLongname('myObject.myProperty')
+
+    //dump(found);
+
+    test('When a symbol is given an alias it is documented as if the name is the alias value.', function() {
+        assert.equal(found[0].longname, 'myObject');
+    });
+
+    test('When a symbol is a member of an alias it is documented as if the memberof is the alias value.', function() {
+        assert.equal(foundMember[0].longname, 'myObject.myProperty');
+        assert.equal(foundMember[0].memberof, 'myObject');
+    });
+
+})();

test/t/cases/modules/data/mod-1.js

@@ -0,0 +1,18 @@
+(function() {
+    var srcParser = require('jsdoc/src/parser'),
+        doclets;
+
+    env.opts._ = [BASEDIR + 'test/cases/modules/'];
+
+    app.jsdoc.parser = new srcParser.Parser();
+
+    require('jsdoc/src/handlers').attachTo(app.jsdoc.parser);
+
+    doclets = app.jsdoc.parser.parse(BASEDIR + 'test/cases/modules/data/mod-1.js')
+
+    test('When a module has no name documented, the name comes from the file path.', function() {
+        assert.ok(doclets.length > 1);
+        assert.equal(doclets[0].name, 'module:data/mod-1');
+    });
+
+})();

test/t/cases/modules/data/mod-2.js

@@ -0,0 +1,18 @@
+(function() {
+    var srcParser = require('jsdoc/src/parser'),
+        doclets;
+
+    env.opts._ = [BASEDIR + 'test/cases/modules/'];
+
+    app.jsdoc.parser = new srcParser.Parser();
+
+    require('jsdoc/src/handlers').attachTo(app.jsdoc.parser);
+
+    doclets = app.jsdoc.parser.parse(BASEDIR + 'test/cases/modules/data/mod-2.js')
+
+    test('When a module has a name documented, that name is used.', function() {
+        assert.ok(doclets.length > 1);
+        assert.equal(doclets[0].name, 'module:my/module/name');
+    });
+
+})();

test/t/cases/modules/data/mod-3.js

@@ -0,0 +1,18 @@
+(function() {
+    var srcParser = require('jsdoc/src/parser'),
+        doclets;
+
+    env.opts._ = [BASEDIR + 'test/cases/modules/'];
+
+    app.jsdoc.parser = new srcParser.Parser();
+
+    require('jsdoc/src/handlers').attachTo(app.jsdoc.parser);
+
+    doclets = app.jsdoc.parser.parse(BASEDIR + 'test/cases/modules/data/mod-2.js')
+
+    test('When a module has a name documented, that name is used.', function() {
+        assert.ok(doclets.length > 1);
+        assert.equal(doclets[0].name, 'module:my/module/name');
+    });
+
+})();