Fixed too many files being open

pkg/docgen/lib/docgen.dart

 // Copyright (c) 2013, 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.
 
 /**
  * **docgen** is a tool for creating machine readable representations of Dart
  * code metadata, including: classes, members, comments and annotations.
  *
  * docgen is run on a `.dart` file or a directory containing `.dart` files.
  *
@@ skipping 465 matching lines @@
  */
 void _writeToFile(String text, String filename, {bool append: false}) {
   Directory dir = new Directory('docs');
   if (!dir.existsSync()) {
     dir.createSync();
   }
   File file = new File('docs/$filename');
   if (!file.existsSync()) {
     file.createSync();
   }
-  file.writeAsString(text, mode: append ? FileMode.APPEND : FileMode.WRITE);
+  file.writeAsStringSync(text, mode: append ? FileMode.APPEND : FileMode.WRITE);

[Emily Fortuna, 2013/08/08 21:07:56]

did you time this on linux? does this increase the run time? If so, could you
maybe just run the async version on linux and the sync version on mac?

[Tate Mandel, 2013/08/08 21:19:13]

I ran each version several times on Linux. 
This version ran in 8.0 +- .2sec every time.
The original ran in 10.0 +- .2sec every time.

Both writeAsString and writeAsStringSync claim to close the file after writing
to it in the docs, but it doesn't seem to be true for the former. The extra
memory usage could cause it to be slower despite being asynchronous.

[Emily Fortuna, 2013/08/08 21:58:22]

Curious! Well, I'm convinced! After you submit this, can you file a bug at
dartbug.com/new about this? People with the io library should investigate what's
going on and make sure it's actually doing what they intend it to be doing. :-)

 }
 
 /**
  * Transforms the map by calling toMap on each value in it.
  */
 Map recurseMap(Map inputMap) {
   var outputMap = {};
   inputMap.forEach((key, value) {
     if (value is Map) {
       outputMap[key] = recurseMap(value);
@@ skipping 542 matching lines @@
   String qualifiedName;
   List<String> parameters;
 
   Annotation(this.qualifiedName, this.parameters);
 
   Map toMap() => {
     'name': qualifiedName,
     'parameters': parameters
   };
 }