OLD | NEW |
---|---|
1 // Copyright (c) 2016, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2016, 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 /// Constants for use in metadata annotations. | 5 /// Constants for use in metadata annotations. |
6 /// | 6 /// |
7 /// See also `@deprecated` and `@override` in the `dart:core` library. | 7 /// See also `@deprecated` and `@override` in the `dart:core` library. |
8 /// | 8 /// |
9 /// Annotations provide semantic information that tools can use to provide a | 9 /// Annotations provide semantic information that tools can use to provide a |
10 /// better user experience. For example, an IDE might not autocomplete the name | 10 /// better user experience. For example, an IDE might not autocomplete the name |
11 /// of a function that's been marked `@deprecated`, or it might display the | 11 /// of a function that's been marked `@deprecated`, or it might display the |
12 /// function's name differently. | 12 /// function's name differently. |
13 /// | 13 /// |
14 /// For information on installing and importing this library, see the | 14 /// For information on installing and importing this library, see the |
15 /// [meta package on pub.dartlang.org] (http://pub.dartlang.org/packages/meta). | 15 /// [meta package on pub.dartlang.org] (http://pub.dartlang.org/packages/meta). |
16 /// For examples of using annotations, see | 16 /// For examples of using annotations, see |
17 /// [Metadata](https://www.dartlang.org/docs/dart-up-and-running/ch02.html#metad ata) | 17 /// [Metadata](https://www.dartlang.org/docs/dart-up-and-running/ch02.html#metad ata) |
18 /// in the language tour. | 18 /// in the language tour. |
19 library meta; | 19 library meta; |
20 | 20 |
21 /// Used to annotate an instance method `m`. Indicates that `m` must either be | 21 /// Used to annotate an instance or static method `m`. Indicates that `m` must |
22 /// abstract or must return a newly allocated object. In addition, every method | 22 /// either be abstract or must return a newly allocated object or `null`. In |
23 /// that either implements or overrides `m` is implicitly annotated with this | 23 /// addition, every method that either implements or overrides `m` is implicitly |
24 /// same annotation. | 24 /// annotated with this same annotation. |
25 /// | 25 /// |
26 /// Tools, such as the analyzer, can provide feedback if | 26 /// Tools, such as the analyzer, can provide feedback if |
27 /// | 27 /// |
28 /// * the annotation is associated with anything other than an instance method, | 28 /// * the annotation is associated with a method that has this annotation that |
29 /// or | 29 /// can return anything other than a newly allocated object or null. |
Brian Wilkerson
2016/06/21 22:28:15
"null" --> "`null`"
Also, restore a variation on
pquitslund
2016/06/21 22:33:36
Done.
| |
30 /// * a method that has this annotation that can return anything other than a | |
31 /// newly allocated object. | |
32 const _Factory factory = const _Factory(); | 30 const _Factory factory = const _Factory(); |
33 | 31 |
34 /// Used to annotate a const constructor `c`. Indicates that any invocation of | 32 /// Used to annotate a const constructor `c`. Indicates that any invocation of |
35 /// the constructor must use the keyword `const` unless one or more of the | 33 /// the constructor must use the keyword `const` unless one or more of the |
36 /// arguments to the constructor is not a compile-time constant. | 34 /// arguments to the constructor is not a compile-time constant. |
37 /// | 35 /// |
38 /// Tools, such as the analyzer, can provide feedback if | 36 /// Tools, such as the analyzer, can provide feedback if |
39 /// | 37 /// |
40 /// * the annotation is associated with anything other than a const constructor, | 38 /// * the annotation is associated with anything other than a const constructor, |
41 /// or | 39 /// or |
(...skipping 87 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
129 const _MustCallSuper(); | 127 const _MustCallSuper(); |
130 } | 128 } |
131 | 129 |
132 class _OptionalTypeArgs { | 130 class _OptionalTypeArgs { |
133 const _OptionalTypeArgs(); | 131 const _OptionalTypeArgs(); |
134 } | 132 } |
135 | 133 |
136 class _Protected { | 134 class _Protected { |
137 const _Protected(); | 135 const _Protected(); |
138 } | 136 } |
OLD | NEW |