| OLD | NEW |
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, 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 part of dart.core; | 5 part of dart.core; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * The annotation `@Deprecated('expires when')` marks a feature as deprecated. | 8 * The annotation `@Deprecated('expires when')` marks a feature as deprecated. |
| 9 * | 9 * |
| 10 * The annotation `@deprecated` is a shorthand for deprecating until | 10 * The annotation `@deprecated` is a shorthand for deprecating until |
| 11 * to an unspecified "next release". | 11 * an unspecified "next release". |
| 12 * | 12 * |
| 13 * The intent of the `@Deprecated` annotation is to inform users of a feature | 13 * The intent of the `@Deprecated` annotation is to inform users of a feature |
| 14 * that they should change their code, even if it is currently still working | 14 * that they should change their code, even if it is currently still working |
| 15 * correctly. | 15 * correctly. |
| 16 * | 16 * |
| 17 * A deprecated feature is scheduled to be removed at a later time, possibly | 17 * A deprecated feature is scheduled to be removed at a later time, possibly |
| 18 * specified as the "expires" field of the annotation. | 18 * specified as the "expires" field of the annotation. |
| 19 * This means that a deprecated feature should not be used, or code using it | 19 * This means that a deprecated feature should not be used, or code using it |
| 20 * will break at some point in the future. If there is code using the feature, | 20 * will break at some point in the future. If there is code using the feature, |
| 21 * that code should be rewritten to not use the deprecated feature. | 21 * that code should be rewritten to not use the deprecated feature. |
| (...skipping 111 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 133 * | 133 * |
| 134 * Tools that understand `@proxy` should tell the user if a class using `@proxy` | 134 * Tools that understand `@proxy` should tell the user if a class using `@proxy` |
| 135 * does not override the `noSuchMethod` declared on [Object]. | 135 * does not override the `noSuchMethod` declared on [Object]. |
| 136 * | 136 * |
| 137 * The intent of the `@proxy` notation is to create objects that implement a | 137 * The intent of the `@proxy` notation is to create objects that implement a |
| 138 * type (or multiple types) that are not known at compile time. If the types | 138 * type (or multiple types) that are not known at compile time. If the types |
| 139 * are known at compile time, a class can be written that implements these | 139 * are known at compile time, a class can be written that implements these |
| 140 * types. | 140 * types. |
| 141 */ | 141 */ |
| 142 const Object proxy = const _Proxy(); | 142 const Object proxy = const _Proxy(); |
| OLD | NEW |