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/api-docs.js

@@ -43,9 +43,11 @@ module.exports = {
           // 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/api-docs.spec.js

@@ -33,6 +33,20 @@ 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' };
+    var moduleMap = {};
+    processor.process([doc1,doc2, doc3], config, new PartialNames(), moduleMap);
+    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

@@ -114,5 +114,6 @@ module.exports = [
 
   { name: 'title' },
   { name: 'parent' },
+  { name: 'packageName' }
 
 ];