add installation instructions to pkg packages

BUG=

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

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart/pkg/source_maps@21770 260f80e4-7a28-3924-810f-c04153c831b5
diff --git a/lib/source_maps.dart b/lib/source_maps.dart
index 4e24dea..1594827 100644
--- a/lib/source_maps.dart
+++ b/lib/source_maps.dart
@@ -4,6 +4,21 @@
 
 /// Source maps library.
 ///
+/// ## Installing ##
+///
+/// Use [pub][] to install this package. Add the following to your
+/// `pubspec.yaml` file.
+///
+///     dependencies:
+///       source_maps: any
+///
+/// Then run `pub install`.
+///
+/// For more information, see the
+/// [source_maps package on pub.dartlang.org][pkg].
+///
+/// ## Using ##
+///
 /// Create a source map using [SourceMapBuilder]. For example:
 ///     var json = (new SourceMapBuilder()
 ///         ..add(inputSpan1, outputSpan1)
@@ -17,6 +32,9 @@
 /// object. For example:
 ///     var mapping = parse(json);
 ///     mapping.spanFor(outputSpan1.line, outputSpan1.column)
+///
+/// [pub]: http://pub.dartlang.org
+/// [pkg]: http://pub.dartlang.org/packages/source_maps
 library source_maps;
 
 export "builder.dart";