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 /// ----------------------------------------------------------------------- | 5 /// ----------------------------------------------------------------------- |
6 /// ERROR HANDLING | 6 /// ERROR HANDLING |
7 /// ----------------------------------------------------------------------- | 7 /// ----------------------------------------------------------------------- |
8 /// | 8 /// |
9 /// As a rule of thumb, errors that can be detected statically are handled by | 9 /// As a rule of thumb, errors that can be detected statically are handled by |
10 /// the frontend, typically by translating the erroneous code into a 'throw' or | 10 /// the frontend, typically by translating the erroneous code into a 'throw' or |
(...skipping 816 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
827 // ------------------------------------------------------------------------ | 827 // ------------------------------------------------------------------------ |
828 // MEMBERS | 828 // MEMBERS |
829 // ------------------------------------------------------------------------ | 829 // ------------------------------------------------------------------------ |
830 | 830 |
831 abstract class Member extends NamedNode { | 831 abstract class Member extends NamedNode { |
832 /// End offset in the source file it comes from. Valid values are from 0 and | 832 /// End offset in the source file it comes from. Valid values are from 0 and |
833 /// up, or -1 ([TreeNode.noOffset]) if the file end offset is not available | 833 /// up, or -1 ([TreeNode.noOffset]) if the file end offset is not available |
834 /// (this is the default if none is specifically set). | 834 /// (this is the default if none is specifically set). |
835 int fileEndOffset = TreeNode.noOffset; | 835 int fileEndOffset = TreeNode.noOffset; |
836 | 836 |
| 837 /// Documentation comment of the member, or `null`. |
| 838 @informative |
| 839 String documentationComment; |
| 840 |
837 /// List of metadata annotations on the member. | 841 /// List of metadata annotations on the member. |
838 /// | 842 /// |
839 /// This defaults to an immutable empty list. Use [addAnnotation] to add | 843 /// This defaults to an immutable empty list. Use [addAnnotation] to add |
840 /// annotations if needed. | 844 /// annotations if needed. |
841 List<Expression> annotations = const <Expression>[]; | 845 List<Expression> annotations = const <Expression>[]; |
842 Name name; | 846 Name name; |
843 | 847 |
844 /// Flags summarizing the kinds of AST nodes contained in this member, for | 848 /// Flags summarizing the kinds of AST nodes contained in this member, for |
845 /// speeding up transformations that only affect certain types of nodes. | 849 /// speeding up transformations that only affect certain types of nodes. |
846 /// | 850 /// |
(...skipping 3829 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
4676 if (typedef_.canonicalName == null) { | 4680 if (typedef_.canonicalName == null) { |
4677 throw '$typedef_ has no canonical name'; | 4681 throw '$typedef_ has no canonical name'; |
4678 } | 4682 } |
4679 return typedef_.canonicalName; | 4683 return typedef_.canonicalName; |
4680 } | 4684 } |
4681 | 4685 |
4682 /// Annotation describing information which is not part of Dart semantics; in | 4686 /// Annotation describing information which is not part of Dart semantics; in |
4683 /// other words, if this information (or any information it refers to) changes, | 4687 /// other words, if this information (or any information it refers to) changes, |
4684 /// static analysis and runtime behavior of the library are unaffected. | 4688 /// static analysis and runtime behavior of the library are unaffected. |
4685 const informative = null; | 4689 const informative = null; |
OLD | NEW |