Updated the schema of the yaml output.

pkg/docgen/lib/dart2yaml.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.
 
 /**
  * This library is used to convert data from a map to a YAML string.
  */
 library dart2yaml;
 
 /**
@@ skipping 35 matching lines @@
       yaml.write(_processElement(documentData[key]));
     }
   });
 }
 
 /**
  * Returns an escaped String form of the inputted element.
  */
 String _processElement(var element) {
   return "\"${element.toString().replaceAll('\\', '\\\\')
-    .replaceAll("\"", "\\\"")}\"\n";
+    .replaceAll("\"", "\\\"").replaceAll("\n", "\\n")}\"\n";

[Bob Nystrom, 2013/07/15 22:16:03]

You can make this a little cleaner if you use raw strings and ':

return '"{element.toString()
    .replaceAll('\\', r'\\')
    .replaceAll('"', r'\"')
    .replaceAll('\n', r'\n')}"';

Also, I would probably move all of the replaceAll calls out of the interpolated
string, like:

var contents = element.toString().replaceAll(...).replaceAll(...);
return '"$contents"';

[janicejl, 2013/07/15 22:38:43]

Done.

 }
 
 /**
  * Based on the depth in the file, this function returns the correct spacing
  * for an element in the YAML output.
  */
 void _calcSpaces(int spaceLevel, StringBuffer yaml) {
   for (int i = 0; i < spaceLevel; i++) {
     yaml.write("  ");
   }
 }