Index: pkg/meta/lib/meta.dart |
diff --git a/pkg/meta/lib/meta.dart b/pkg/meta/lib/meta.dart |
index 9960d59d02ff09f48bef612279e2b9d6f01f86ad..e3e4a250753c5b613716ce9f3c75b2298a663389 100644 |
--- a/pkg/meta/lib/meta.dart |
+++ b/pkg/meta/lib/meta.dart |
@@ -3,24 +3,21 @@ |
// BSD-style license that can be found in the LICENSE file. |
/** |
- * This library contains the definitions of annotations that provide additional |
- * semantic information about the program being annotated. These annotations are |
- * intended to be used by tools to provide a better user experience. |
+ * Constants for use in metadata annotations such as |
+ * `@deprecated`, `@override`, and `@proxy`. |
+ * |
+ * Annotations provide semantic information |
+ * that tools can use to provide a better user experience. |
+ * For example, an IDE might not autocomplete |
+ * the name of a function that's been marked `@deprecated`, |
+ * or it might display the function's name differently. |
* |
- * ## Installing ## |
- * |
- * Use [pub][] to install this package. Add the following to your `pubspec.yaml` |
- * file. |
- * |
- * dependencies: |
- * meta: any |
- * |
- * Then run `pub install`. |
- * |
- * For more information, see the |
- * [meta package on pub.dartlang.org](http://pub.dartlang.org/packages/meta). |
- * |
- * [pub]: http://pub.dartlang.org |
+ * For information on installing and importing this library, see the |
+ * [meta package on pub.dartlang.org] |
+ * (http://pub.dartlang.org/packages/meta). |
+ * For examples of using annotations, see |
+ * [Metadata](https://www.dartlang.org/docs/dart-up-and-running/contents/ch02.html#ch02-metadata) |
+ * in the language tour. |
*/ |
library meta; |