add a comment to the generated lock file

Review URL: https://codereview.chromium.org//12133002

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge@17951 260f80e4-7a28-3924-810f-c04153c831b5

lib/src/lock_file.dart

@@ -26,7 +26,6 @@ class LockFile {
     var packages = <String, PackageId>{};
 
     if (contents.trim() == '') return new LockFile.empty();
-
     var parsed = loadYaml(contents);
 
     if (parsed.containsKey('packages')) {
@@ -85,6 +84,9 @@ class LockFile {
 
     // TODO(nweiz): Serialize using the YAML library once it supports
     // serialization. For now, we use JSON, since it's a subset of YAML anyway.
-    return json.stringify({'packages': packagesObj});
+    return '''
+        # Generated by pub. See: http://pub.dartlang.org/doc/glossary.html#lockfile
+         ${json.stringify({'packages': packagesObj})}
+        ''';
   }
 }