Chromium Code Reviews| 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 |