Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(118)

Side by Side Diff: pkg/meta/lib/meta.dart

Issue 2087953003: Update `@factory` to allow for statics and nulls. (Closed) Base URL: git@github.com:dart-lang/sdk.git@master
Patch Set: Created 4 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « pkg/meta/CHANGELOG.md ('k') | pkg/meta/pubspec.yaml » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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 }
OLDNEW
« no previous file with comments | « pkg/meta/CHANGELOG.md ('k') | pkg/meta/pubspec.yaml » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698