Allow apidoc to skip MDN database.json entries that are bogus.

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 221 matching lines @@
 }
 
 class Apidoc extends doc.Dartdoc {
   /** Big ball of JSON containing the scraped MDN documentation. */
   final Map mdn;
 
   final Htmldoc htmldoc;
 
   static const disqusShortname = 'dartapidocs';
 
+  // A set of type names (TypeMirror.simpleName values) to ignore while
+  // looking up information from MDN data.  TODO(eub, jacobr): fix up the MDN
+  // import scripts so they run correctly and generate data that doesn't have
+  // any entries that need to be ignored.
+  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;
 
   Apidoc(this.mdn, this.htmldoc, Path outputDir, int mode,
          bool generateAppCache) {
     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';
     mainUrl = 'http://dartlang.org';
 
     final note    = 'http://code.google.com/policies.html#restrictions';
     final cca     = 'http://creativecommons.org/licenses/by/3.0/';
     final bsd     = 'http://code.google.com/google_bsd_license.html';
     final tos     = 'http://www.dartlang.org/tos.html';
     final privacy = 'http://www.google.com/intl/en/privacy/privacy-policy.html';
 
     footerText =
@@ skipping 176 matching lines @@
           </p>
           ''');
     }
   }
 
   /**
    * Gets the MDN-scraped docs for [type], or `null` if this type isn't
    * scraped from MDN.
    */
   includeMdnTypeComment(TypeMirror type) {
+    if (_mdnTypeNamesToSkip.contains(type.simpleName)) {
+      print('Skipping MDN type ${type.simpleName}');
+      return null;
+    }
+
     var typeString = '';
     if (type.library.simpleName == HTML_LIBRARY_NAME) {
       // If it's an HTML type, try to map it to a base DOM type so we can find
       // the MDN docs.
       final domTypes = _diff.htmlTypesToDom[type.qualifiedName];
 
       // Couldn't find a DOM type.
       if ((domTypes == null) || (domTypes.length != 1)) return null;
 
       // Use the corresponding DOM type when searching MDN.
@@ skipping 71 matching lines @@
     final typeName = member.surroundingDeclaration.simpleName;
     var memberName = '$typeName.${member.simpleName}';
     if (member is MethodMirror && (member.isConstructor || member.isFactory)) {
       final separator = member.constructorName == '' ? '' : '.';
       memberName = 'new $typeName$separator${member.constructorName}';
     }
 
     return a(memberUrl(member), memberName);
   }
 }