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 578 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
589 /// up, or -1 ([TreeNode.noOffset]) if the file end offset is not available | 589 /// up, or -1 ([TreeNode.noOffset]) if the file end offset is not available |
590 /// (this is the default if none is specifically set). | 590 /// (this is the default if none is specifically set). |
591 int fileEndOffset = TreeNode.noOffset; | 591 int fileEndOffset = TreeNode.noOffset; |
592 | 592 |
593 /// Offset of the declaration, set and used when writing the binary. | 593 /// Offset of the declaration, set and used when writing the binary. |
594 int binaryOffset = -1; | 594 int binaryOffset = -1; |
595 | 595 |
596 /// The degree to which the contents of the class have been loaded. | 596 /// The degree to which the contents of the class have been loaded. |
597 ClassLevel level = ClassLevel.Body; | 597 ClassLevel level = ClassLevel.Body; |
598 | 598 |
| 599 /// Documentation comment of the class, or `null`. |
| 600 @informative |
| 601 String documentationComment; |
| 602 |
599 /// List of metadata annotations on the class. | 603 /// List of metadata annotations on the class. |
600 /// | 604 /// |
601 /// This defaults to an immutable empty list. Use [addAnnotation] to add | 605 /// This defaults to an immutable empty list. Use [addAnnotation] to add |
602 /// annotations if needed. | 606 /// annotations if needed. |
603 List<Expression> annotations = const <Expression>[]; | 607 List<Expression> annotations = const <Expression>[]; |
604 | 608 |
605 /// Name of the class. | 609 /// Name of the class. |
606 /// | 610 /// |
607 /// Must be non-null and must be unique within the library. | 611 /// Must be non-null and must be unique within the library. |
608 /// | 612 /// |
(...skipping 4018 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
4627 /// typedef has not been assigned a canonical name yet. | 4631 /// typedef has not been assigned a canonical name yet. |
4628 /// | 4632 /// |
4629 /// Returns `null` if the typedef is `null`. | 4633 /// Returns `null` if the typedef is `null`. |
4630 CanonicalName getCanonicalNameOfTypedef(Typedef typedef_) { | 4634 CanonicalName getCanonicalNameOfTypedef(Typedef typedef_) { |
4631 if (typedef_ == null) return null; | 4635 if (typedef_ == null) return null; |
4632 if (typedef_.canonicalName == null) { | 4636 if (typedef_.canonicalName == null) { |
4633 throw '$typedef_ has no canonical name'; | 4637 throw '$typedef_ has no canonical name'; |
4634 } | 4638 } |
4635 return typedef_.canonicalName; | 4639 return typedef_.canonicalName; |
4636 } | 4640 } |
| 4641 |
| 4642 /// Annotation describing information which is not part of Dart semantics; in |
| 4643 /// other words, if this information (or any information it refers to) changes, |
| 4644 /// static analysis and runtime behavior of the library are unaffected. |
| 4645 const informative = null; |
OLD | NEW |