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 |
(...skipping 51 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
62 /// Used to annotate a class declaration `C`. Indicates that any type arguments | 62 /// Used to annotate a class declaration `C`. Indicates that any type arguments |
63 /// declared on `C` are to be treated as optional. Tools such as the analyzer | 63 /// declared on `C` are to be treated as optional. Tools such as the analyzer |
64 /// and linter can use this information to suppress warnings that would | 64 /// and linter can use this information to suppress warnings that would |
65 /// otherwise require type arguments to be provided for instances of `C`. | 65 /// otherwise require type arguments to be provided for instances of `C`. |
66 const _OptionalTypeArgs optionalTypeArgs = const _OptionalTypeArgs(); | 66 const _OptionalTypeArgs optionalTypeArgs = const _OptionalTypeArgs(); |
67 | 67 |
68 /// Used to annotate an instance member (method, getter, setter, operator, or | 68 /// Used to annotate an instance member (method, getter, setter, operator, or |
69 /// field) `m` in a class `C`. If the annotation is on a field it applies to the | 69 /// field) `m` in a class `C`. If the annotation is on a field it applies to the |
70 /// getter, and setter if appropriate, that are induced by the field. Indicates | 70 /// getter, and setter if appropriate, that are induced by the field. Indicates |
71 /// that `m` should only be invoked from instance methods of `C` or classes that | 71 /// that `m` should only be invoked from instance methods of `C` or classes that |
72 /// extend or mix in `C`, either directly or indirectly. Additionally indicates | 72 /// extend, implement or mix in `C`, either directly or indirectly. Additionally |
73 /// that `m` should only be invoked on `this`, whether explicitly or implicitly. | 73 /// indicates that `m` should only be invoked on `this`, whether explicitly or |
| 74 /// implicitly. |
74 /// | 75 /// |
75 /// Tools, such as the analyzer, can provide feedback if | 76 /// Tools, such as the analyzer, can provide feedback if |
76 /// | 77 /// |
77 /// * the annotation is associated with anything other than an instance member, | 78 /// * the annotation is associated with anything other than an instance member, |
78 /// or | 79 /// or |
79 /// * an invocation of a member that has this annotation is used outside of an | 80 /// * an invocation of a member that has this annotation is used outside of an |
80 /// instance member defined on a class that extends or mixes in the class in | 81 /// instance member defined on a class that extends or mixes in the class in |
81 /// which the protected member is defined, or that uses a receiver other than | 82 /// which the protected member is defined, or that uses a receiver other than |
82 /// `this`. | 83 /// `this`. |
83 const _Protected protected = const _Protected(); | 84 const _Protected protected = const _Protected(); |
(...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
128 const _MustCallSuper(); | 129 const _MustCallSuper(); |
129 } | 130 } |
130 | 131 |
131 class _OptionalTypeArgs { | 132 class _OptionalTypeArgs { |
132 const _OptionalTypeArgs(); | 133 const _OptionalTypeArgs(); |
133 } | 134 } |
134 | 135 |
135 class _Protected { | 136 class _Protected { |
136 const _Protected(); | 137 const _Protected(); |
137 } | 138 } |
OLD | NEW |