Restructure YAML package suitable for pub lish

utils/pub/yaml/lib/yaml.dart

Index: utils/pub/yaml/lib/yaml.dart
diff --git a/utils/pub/yaml/yaml.dart b/utils/pub/yaml/lib/yaml.dart
similarity index 84%
rename from utils/pub/yaml/yaml.dart
rename to utils/pub/yaml/lib/yaml.dart
index 3918743f508fd38d34d9140d0000e7cb7837971a..c8a39cc30d07383c10019b275f83bc75414338cc 100644
--- a/utils/pub/yaml/yaml.dart
+++ b/utils/pub/yaml/lib/yaml.dart
@@ -2,6 +2,18 @@
 // 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/).
+ *
+ * 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']);
+ *     }
+ */

[nweiz, 2012/12/18 18:45:17]

It would be good to mention that this library currently doesn't support dumping
to YAML, and that JSON.stringify should be used instead.

Also, please use "///"-style comments.

[Jennifer Messerly, 2012/12/18 18:59:31]

Sure.
 
Confused. The rest of the file does not follow that style. "///" would violate
the number one style rule -- be consistent.

[nweiz, 2012/12/18 19:02:53]

Our policy in pub, which I think makes sense for this library, is to gradually
move comments over to "///" style when we touch them or write new ones.

 library yaml;
 
 import 'dart:math' as Math;