Fix ApiDoc to work with new dart:html code. Tweak dart:html generator to generate clearer @domName …

lib/dartdoc/utils.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.
 
 // Generic utility functions.
 
 /** Turns [name] into something that's safe to use as a file name. */
 String sanitize(String name) => name.replaceAll(':', '_').replaceAll('/', '_');
 
 /** Returns the number of times [search] occurs in [text]. */
@@ skipping 30 matching lines @@
   for (start = 0; start < Math.min(indentation, text.length); start++) {
     // Stop if we hit a non-whitespace character.
     if (text[start] != ' ') break;
   }
 
   return text.substring(start);
 }
 
 /** Sorts the map by the key, doing a case-insensitive comparison. */
 List orderByName(Map<String, Dynamic> map) {
-  // TODO(rnystrom): it'd be nice to have this in corelib.
   List keys = map.getKeys();
-  keys.sort((x, y) => x.toUpperCase().compareTo(y.toUpperCase()));
+  keys.sort((a, b) {
+    // Hack: make sure $dom methods show up last in the list not first.

[Bob Nystrom, 2012/04/12 17:54:06]

Take credit for it. :)

// TODO(jacobr): ...

+    String transformName(String name) =>
+      name.toUpperCase().replaceFirst(const RegExp('\\\$DOM_'), 'zzzz');
+
+    return transformName(a).compareTo(transformName(b));
+  });
   final values = [];
   for (var k in keys) {
     values.add(map[k]);
   }
   return values;
 }
 
 /**
  * Joins [items] into a single, comma-separated string using [conjunction].
  * E.g. `['A', 'B', 'C']` becomes `"A, B, and C"`.
  */
 String joinWithCommas(List<String> items, [String conjunction = 'and']) {
   if (items.length == 1) return items[0];
   if (items.length == 2) return "${items[0]} $conjunction ${items[1]}";
   return Strings.join(items.getRange(0, items.length - 1), ', ') +
     ', $conjunction ' + items[items.length - 1];
 }