Add logic to exclude certain libraries from API doc.

utils/apidoc/apidoc.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * This generates the reference documentation for the core libraries that come
  * with dart. It is built on top of dartdoc, which is a general-purpose library
  * for generating docs from any Dart code. This library extends that to include
  * additional information and styling specific to our standard library.
  *
@@ skipping 15 matching lines @@
 
 HtmlDiff _diff;
 
 void main() {
   final args = new Options().arguments;
 
   int mode = doc.MODE_STATIC;
   Path outputDir = new Path('docs');
   bool generateAppCache = false;
 
+  List<String> excludedLibraries = <String>[];
+
   // Parse the command-line arguments.
   for (int i = 0; i < args.length; i++) {
     final arg = args[i];
 
     switch (arg) {
       case '--mode=static':
         mode = doc.MODE_STATIC;
         break;
 
       case '--mode=live-nav':
         mode = doc.MODE_LIVE_NAV;
         break;
 
       case '--generate-app-cache=true':
         generateAppCache = true;
         break;
 
       default:
-        if (arg.startsWith('--out=')) {
+        if (arg.startsWith('--exclude-lib=')) {
+          excludedLibraries.add(arg.substring('--exclude-lib='.length));
+        } else if (arg.startsWith('--out=')) {
           outputDir = new Path.fromNative(arg.substring('--out='.length));
         } else {
           print('Unknown option: $arg');
           return;
         }
         break;
     }
   }
 
   final libPath = doc.scriptDir.append('../../');
@@ skipping 58 matching lines @@
     } else if (new File.fromPath(newStylePath).existsSync()) {
       apidocLibraries.add(newStylePath);
       includedLibraries.add(libName);
     } else {
       print('Warning: could not find package at $path');
     }
   };
 
   lister.onDone = (success) {
     print('Generating docs...');
-    final apidoc = new Apidoc(mdn, htmldoc, outputDir, mode, generateAppCache);
+    final apidoc = new Apidoc(mdn, htmldoc, outputDir, mode, generateAppCache,
+        excludedLibraries);
     apidoc.dartdocPath = doc.scriptDir.append('../../pkg/dartdoc/');
     // Select the libraries to include in the produced documentation:
     apidoc.includeApi = true;
     apidoc.includedLibraries = includedLibraries;
 
     Futures.wait([copiedStatic, copiedApiDocStatic]).then((_) {
       apidoc.documentLibraries(apidocLibraries, libPath, pkgPath);
 
       final compiled = doc.compileScript(mode, outputDir, libPath);
 
@@ skipping 107 matching lines @@
   static Set<String> _mdnTypeNamesToSkip = null;
 
   /**
    * The URL to the page on MDN that content was pulled from for the current
    * type being documented. Will be `null` if the type doesn't use any MDN
    * content.
    */
   String mdnUrl = null;
 
   Apidoc(this.mdn, this.htmldoc, Path outputDir, int mode,
-         bool generateAppCache) {
+         bool generateAppCache, [excludedLibraries]) {
+    if (?excludedLibraries) {
+      this.excludedLibraries = excludedLibraries;
+    }
+
     this.outputDir = outputDir;
     this.mode = mode;
     this.generateAppCache = generateAppCache;
 
     // Skip bad entries in the checked-in mdn/database.json:
     //  * UnknownElement has a top-level Gecko DOM page in German.
     if (_mdnTypeNamesToSkip == null)
       _mdnTypeNamesToSkip = new Set.from(['UnknownElement']);
 
     mainTitle = 'Dart API Reference';
@@ skipping 297 matching lines @@
    return '''
         <div class="mdn">
         $mdnComment
         <div class="mdn-note"><a href="$mdnUrl">from MDN</a></div>
         </div>
         ''';
   }
 
   String toString() => mdnComment;
 }