Add a script to generate HTML and DOM docs with cross-links to one another.

utils/dartdoc/utils.dart

 // Copyright (c) 2011, 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.
 
 /** Invokes [callback] and returns how long it took to execute in ms. */
 num time(callback()) {
   final watch = new Stopwatch();
   watch.start();
@@ skipping 47 matching lines @@
 /** 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()));
   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];
+}