docs(*): add @publicModule tags

Initial set of tags to demonstrate the public docs filtering

Closes angular#988

Author: petebacondarwin

docs/dgeni-package/processors/processClassDocs.js

@@ -5,8 +5,10 @@ module.exports = function processClassDocs(log, getJSDocComment) {
   return {
     $runAfter: ['processModuleDocs'],
     $runBefore: ['parsing-tags', 'generateDocsFromComments'],
+    ignorePrivateMembers: false,
     $process: function(docs) {
       var memberDocs = [];
+      var ignorePrivateMembers = this.ignorePrivateMembers;
       _.forEach(docs, function(classDoc) {
         if ( classDoc.docType === 'class' ) {
 
@@ -15,13 +17,16 @@ module.exports = function processClassDocs(log, getJSDocComment) {
           // Create a new doc for each member of the class
           _.forEach(classDoc.elements, function(memberDoc) {
 
+            if (ignorePrivateMembers && memberDoc.name.literalToken.value.charAt(0) === '_') return;
+
             classDoc.members.push(memberDoc);
             memberDocs.push(memberDoc);
 
             memberDoc.docType = 'member';
             memberDoc.classDoc = classDoc;
             memberDoc.name = memberDoc.name.literalToken.value;
 
+
             if (memberDoc.commentBefore ) {
               // If this export has a comment, remove it from the list of
               // comments collected in the module

docs/dgeni-package/services/ExportTreeVisitor.js

@@ -17,8 +17,10 @@ module.exports = function ExportTreeVisitor(ParseTreeVisitor, log) {
       ParseTreeVisitor.prototype.visitExportDeclaration.call(this, tree);
       log.silly('exit', this.currentExport);
 
-      // We are exiting the export declaration - store the export object
-      this.exports.push(this.currentExport);
+      if(this.currentExport) {
+        // We are exiting the export declaration - store the export object
+        this.exports.push(this.currentExport);
+      }
       this.currentExport = null;
     },
 
@@ -78,14 +80,15 @@ module.exports = function ExportTreeVisitor(ParseTreeVisitor, log) {
     },
 
     visitNamedExport: function(tree) {
-      if ( this.currentExport ) {
-        this.updateExport(tree);
+      this.currentExport = null;
+      // if ( this.currentExport ) {
+      //   this.updateExport(tree);
 
-        this.currentExport.namedExport = tree;
-        this.currentExport.name = 'NAMED_EXPORT';
-        // TODO: work out this bit!!
-        // We need to cope with any export specifiers in the named export
-      }
+      //   this.currentExport.namedExport = tree;
+      //   this.currentExport.name = 'NAMED_EXPORT';
+      //   // TODO: work out this bit!!
+      //   // We need to cope with any export specifiers in the named export
+      // }
     },
 
     // TODO - if the export is an expression, find the thing that is being

docs/public-docs-package/index.js

@@ -10,6 +10,10 @@ module.exports = new Package('angular-public', [basePackage])
   parseTagsProcessor.tagDefinitions.push({ name: 'publicModule' });
 })
 
+.config(function(processClassDocs) {
+  processClassDocs.ignorePrivateMembers = true;
+})
+
 // Configure file writing
 .config(function(writeFilesProcessor) {
   writeFilesProcessor.outputFolder  = 'dist/public_docs';