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

Side by Side Diff: pkg/kernel/lib/ast.dart

Issue 2990873002: Add Member.documentationComment and use it to resynthesize documentation from Kernel. (Closed)
Patch Set: Created 3 years, 4 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
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 /// ----------------------------------------------------------------------- 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
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
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;
OLDNEW
« no previous file with comments | « pkg/front_end/lib/src/fasta/source/source_library_builder.dart ('k') | pkg/kernel/lib/binary/ast_from_binary.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698