OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 /** | 5 /** |
6 * This library contains the definitions of annotations that provide additional | 6 * This library contains the definitions of annotations that provide additional |
7 * semantic information about the program being annotated. These annotations are | 7 * semantic information about the program being annotated. These annotations are |
8 * intended to be used by tools to provide a better user experience. | 8 * intended to be used by tools to provide a better user experience. |
| 9 * |
| 10 * ## Installing ## |
| 11 * |
| 12 * Use [pub][] to install this package. Add the following to your `pubspec.yaml` |
| 13 * file. |
| 14 * |
| 15 * dependencies: |
| 16 * meta: any |
| 17 * |
| 18 * Then run `pub install`. |
| 19 * |
| 20 * For more information, see the |
| 21 * [meta package on pub.dartlang.org](http://pub.dartlang.org/packages/meta). |
| 22 * |
| 23 * [pub]: http://pub.dartlang.org |
9 */ | 24 */ |
10 library meta; | 25 library meta; |
11 | 26 |
12 /** | 27 /** |
13 * An annotation used to mark a class, field, getter, setter, method, top-level | 28 * An annotation used to mark a class, field, getter, setter, method, top-level |
14 * variable, or top-level function as one that should no longer be used. Tools | 29 * variable, or top-level function as one that should no longer be used. Tools |
15 * can use this annotation to provide a warning on references to the marked | 30 * can use this annotation to provide a warning on references to the marked |
16 * element. | 31 * element. |
17 */ | 32 */ |
18 const deprecated = const _Deprecated(); | 33 const deprecated = const _Deprecated(); |
19 | 34 |
20 class _Deprecated { | 35 class _Deprecated { |
21 const _Deprecated(); | 36 const _Deprecated(); |
22 } | 37 } |
23 | 38 |
24 /** | 39 /** |
25 * An annotation used to mark an instance member (method, field, getter or | 40 * An annotation used to mark an instance member (method, field, getter or |
26 * setter) as overriding an inherited class member. Tools can use this | 41 * setter) as overriding an inherited class member. Tools can use this |
27 * annotation to provide a warning if there is no overridden member. | 42 * annotation to provide a warning if there is no overridden member. |
28 */ | 43 */ |
29 const override = const _Override(); | 44 const override = const _Override(); |
30 | 45 |
31 class _Override { | 46 class _Override { |
32 const _Override(); | 47 const _Override(); |
33 } | 48 } |
OLD | NEW |