feat(api-docs): allow packageName to be specified as a tag

See angular/angular.js#7284
See angular/angular.js#8038

Author: petebacondarwin

ngdoc/processors/apiDocs.js

@@ -40,9 +40,11 @@ module.exports = function apiDocsProcessor(log, partialNameMap, moduleMap) {
             // Compute the package name and filename for the module
             var match = /^ng(.*)/.exec(doc.name);
             if ( match ) {
-              var packageName = match[1].toLowerCase();
-              if ( packageName ) { packageName = '-' + packageName; }
-              doc.packageName = 'angular' + packageName;
+              if ( !doc.packageName ) {
+                var packageName = match[1].toLowerCase();
+                if ( packageName ) { packageName = '-' + packageName; }
+                doc.packageName = 'angular' + packageName;
+              }
               doc.packageFile = doc.packageName + '.js';
             }
 

ngdoc/spec/processors/apiDocs.spec.js

@@ -35,6 +35,19 @@ describe("api-docs processor", function() {
     });
   });
 
+  it("should compute the packageName and packageFile if not already provided", function() {
+    var doc1 = { area: 'api', docType: 'module', name: 'ng' };
+    var doc2 = { area: 'api', docType: 'module', name: 'ngResource' };
+    var doc3 = { area: 'api', docType: 'module', name: 'ngMock', packageName: 'angular-mocks' };
+    processor.$process([doc1,doc2, doc3]);
+    expect(doc1.packageName).toEqual('angular');
+    expect(doc1.packageFile).toEqual('angular.js');
+    expect(doc2.packageName).toEqual('angular-resource');
+    expect(doc2.packageFile).toEqual('angular-resource.js');
+    expect(doc3.packageName).toEqual('angular-mocks');
+    expect(doc3.packageFile).toEqual('angular-mocks.js');
+  });
+
   it("should extract the container and member from the name if it is a memberOf type", function() {
     var doc = {
       docType: 'method',

ngdoc/tag-defs/index.js

@@ -11,5 +11,6 @@ module.exports = [
   require('./fullName'),
   require('./priority'),
   require('./title'),
-  require('./parent')
+  require('./parent'),
+  require('./packageName')
 ];

ngdoc/tag-defs/packageName.js

@@ -0,0 +1,3 @@
+module.exports = function() {
+  return { name: 'packageName' };
+};