Restructure YAML package suitable for pub lish

pkg/yaml/lib/yaml.dart

Index: pkg/yaml/lib/yaml.dart
diff --git a/utils/pub/yaml/yaml.dart b/pkg/yaml/lib/yaml.dart
similarity index 74%
rename from utils/pub/yaml/yaml.dart
rename to pkg/yaml/lib/yaml.dart
index a73736d4b8b076b90e522a5091f097c94b6d562b..ef0ac830b640035a5e72f7a8d980d7e5fdbe9e9a 100644
--- a/utils/pub/yaml/yaml.dart
+++ b/pkg/yaml/lib/yaml.dart
@@ -2,6 +2,26 @@
 // 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.
 
+/// A parser for [YAML](http://www.yaml.org/).

[Bob Nystrom, 2013/01/26 01:39:33]

Maybe a quick README.md file with this too?

[Jennifer Messerly, 2013/01/26 01:42:38]

Sure. Anything else I should say besides this content here?
Maybe a link to code.google.com/p/dart and issue tracker?

Also it looks like we need readmes in all of the PKG things :)

+///
+/// Use [loadYaml] to load a single document, or [loadYamlStream] to load a
+/// stream of documents. For example:
+///
+///     import 'package:yaml/yaml.dart';
+///     main() {
+///       var doc = loadYaml("YAML: YAML Ain't Markup Language");
+///       print(doc['YAML']);
+///     }
+///
+/// This library currently doesn't support dumping to YAML. You should use
+/// `stringify` from `dart:json` instead:
+///
+///     import 'dart:json' as json;
+///     import 'package:yaml/yaml.dart';
+///     main() {
+///       var doc = loadYaml("YAML: YAML Ain't Markup Language");
+///       print(json.stringify(doc));
+///     }
 library yaml;
 
 import 'dart:math' as Math;