Restructure YAML package suitable for pub lish

utils/pub/yaml/lib/yaml.dart

 // Copyright (c) 2012, 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.
 
+/**
+ * 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;
 
 import 'deep_equals.dart';
 
 part 'yaml_map.dart';
 part 'model.dart';
 part 'parser.dart';
 part 'visitor.dart';
@@ skipping 33 matching lines @@
 }
 
 /** An error thrown by the YAML processor. */
 class YamlException implements Exception {
   String msg;
 
   YamlException(this.msg);
 
   String toString() => msg;
 }