| 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 |