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

Side by Side Diff: pkg/analyzer/lib/dart/element/element.dart

Issue 2948393002: Clean up type parameters in comments (Closed)
Patch Set: Created 3 years, 5 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/analyzer/lib/dart/ast/ast_factory.dart ('k') | pkg/analyzer/lib/src/cancelable_future.dart » ('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) 2014, the Dart project authors. Please see the AUTHORS file 1 // Copyright (c) 2014, 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 * Defines the element model. The element model describes the semantic (as 6 * Defines the element model. The element model describes the semantic (as
7 * opposed to syntactic) structure of Dart code. The syntactic structure of the 7 * opposed to syntactic) structure of Dart code. The syntactic structure of the
8 * code is modeled by the [AST structure](../ast/ast.dart). 8 * code is modeled by the [AST structure](../ast/ast.dart).
9 * 9 *
10 * The element model consists of two closely related kinds of objects: elements 10 * The element model consists of two closely related kinds of objects: elements
(...skipping 706 matching lines...) Expand 10 before | Expand all | Expand 10 after
717 * 717 *
718 * This method is expensive, because resolved AST might have been already 718 * This method is expensive, because resolved AST might have been already
719 * evicted from cache, so parsing and resolving will be performed. 719 * evicted from cache, so parsing and resolving will be performed.
720 */ 720 */
721 CompilationUnit get unit; 721 CompilationUnit get unit;
722 722
723 /** 723 /**
724 * Use the given [visitor] to visit this element. Return the value returned by 724 * Use the given [visitor] to visit this element. Return the value returned by
725 * the visitor as a result of visiting this element. 725 * the visitor as a result of visiting this element.
726 */ 726 */
727 /*=T*/ accept/*<T>*/(ElementVisitor<dynamic/*=T*/ > visitor); 727 T accept<T>(ElementVisitor<T> visitor);
728 728
729 /** 729 /**
730 * Return the documentation comment for this element as it appears in the 730 * Return the documentation comment for this element as it appears in the
731 * original source (complete with the beginning and ending delimiters), or 731 * original source (complete with the beginning and ending delimiters), or
732 * `null` if this element does not have a documentation comment associated 732 * `null` if this element does not have a documentation comment associated
733 * with it. This can be a long-running operation if the information needed to 733 * with it. This can be a long-running operation if the information needed to
734 * access the comment is not cached. 734 * access the comment is not cached.
735 * 735 *
736 * Throws [AnalysisException] if the documentation comment could not be 736 * Throws [AnalysisException] if the documentation comment could not be
737 * determined because the analysis could not be performed 737 * determined because the analysis could not be performed
(...skipping 13 matching lines...) Expand all
751 * 751 *
752 * <b>Note:</b> This method cannot be used in an async environment. 752 * <b>Note:</b> This method cannot be used in an async environment.
753 */ 753 */
754 AstNode computeNode(); 754 AstNode computeNode();
755 755
756 /** 756 /**
757 * Return the most immediate ancestor of this element for which the 757 * Return the most immediate ancestor of this element for which the
758 * [predicate] returns `true`, or `null` if there is no such ancestor. Note 758 * [predicate] returns `true`, or `null` if there is no such ancestor. Note
759 * that this element will never be returned. 759 * that this element will never be returned.
760 */ 760 */
761 Element/*=E*/ getAncestor/*<E extends Element >*/( 761 E getAncestor<E extends Element>(Predicate<Element> predicate);
762 Predicate<Element> predicate);
763 762
764 /** 763 /**
765 * Return a display name for the given element that includes the path to the 764 * Return a display name for the given element that includes the path to the
766 * compilation unit in which the type is defined. If [shortName] is `null` 765 * compilation unit in which the type is defined. If [shortName] is `null`
767 * then [displayName] will be used as the name of this element. Otherwise 766 * then [displayName] will be used as the name of this element. Otherwise
768 * the provided name will be used. 767 * the provided name will be used.
769 */ 768 */
770 // TODO(brianwilkerson) Make the parameter optional. 769 // TODO(brianwilkerson) Make the parameter optional.
771 String getExtendedDisplayName(String shortName); 770 String getExtendedDisplayName(String shortName);
772 771
(...skipping 1312 matching lines...) Expand 10 before | Expand all | Expand 10 after
2085 DartType get type; 2084 DartType get type;
2086 2085
2087 /** 2086 /**
2088 * Return a representation of the value of this variable, forcing the value 2087 * Return a representation of the value of this variable, forcing the value
2089 * to be computed if it had not previously been computed, or `null` if either 2088 * to be computed if it had not previously been computed, or `null` if either
2090 * this variable was not declared with the 'const' modifier or if the value of 2089 * this variable was not declared with the 'const' modifier or if the value of
2091 * this variable could not be computed because of errors. 2090 * this variable could not be computed because of errors.
2092 */ 2091 */
2093 DartObject computeConstantValue(); 2092 DartObject computeConstantValue();
2094 } 2093 }
OLDNEW
« no previous file with comments | « pkg/analyzer/lib/dart/ast/ast_factory.dart ('k') | pkg/analyzer/lib/src/cancelable_future.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698