Skip to content

Commit 13d11b4

Browse files
scheglovCommit Queue
authored andcommitted
Elements. Update documentation references in element2.
Change-Id: I9ff4898faf3fb59fcaa26829c99f5e3d669586ef Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/412183 Reviewed-by: Paul Berry <[email protected]> Commit-Queue: Konstantin Shcheglov <[email protected]>
1 parent 1739d87 commit 13d11b4

File tree

1 file changed

+18
-20
lines changed

1 file changed

+18
-20
lines changed

pkg/analyzer/lib/dart/element/element2.dart

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
// for details. All rights reserved. Use of this source code is governed by a
33
// BSD-style license that can be found in the LICENSE file.
44

5-
// ignore_for_file: analyzer_use_new_elements
6-
75
/// Defines the elements and fragments that are part of the element model.
86
///
97
/// The element model describes the semantic (as opposed to syntactic) structure
@@ -25,7 +23,7 @@
2523
///
2624
/// Some elements, such as a [LocalVariableElement2] are declared by a single
2725
/// declaration, but most elements can be declared by multiple declarations. A
28-
/// fragment represents a single declararation when the corresponding element
26+
/// fragment represents a single declaration when the corresponding element
2927
/// can have multiple declarations. There is no fragment for an element that can
3028
/// only have one declaration.
3129
///
@@ -463,7 +461,7 @@ abstract class Element2 {
463461
/// Library that contains this element.
464462
///
465463
/// This will be the element itself if it's a library element. This will be
466-
/// `null` if this element is a [MultiplyDefinedElement] that isn't contained
464+
/// `null` if this element is a [MultiplyDefinedElement2] that isn't contained
467465
/// in a single library.
468466
LibraryElement2? get library2;
469467

@@ -1350,7 +1348,7 @@ abstract class InterfaceElement2 implements InstanceElement2 {
13501348

13511349
/// The constructors defined for this element.
13521350
///
1353-
/// The list is empty for [MixinElement].
1351+
/// The list is empty for [MixinElement2].
13541352
List<ConstructorElement2> get constructors2;
13551353

13561354
@override
@@ -1371,9 +1369,9 @@ abstract class InterfaceElement2 implements InstanceElement2 {
13711369
/// The mixins that are applied to the class being extended in order to
13721370
/// derive the superclass of this class.
13731371
///
1374-
/// [ClassElement] and [EnumElement] can have mixins.
1372+
/// [ClassElement2] and [EnumElement2] can have mixins.
13751373
///
1376-
/// [MixinElement] cannot have mixins, so an empty list is returned.
1374+
/// [MixinElement2] cannot have mixins, so an empty list is returned.
13771375
///
13781376
/// <b>Note:</b> Because the element model represents the state of the code,
13791377
/// it is possible for it to be semantically invalid. In particular, it is not
@@ -1384,13 +1382,13 @@ abstract class InterfaceElement2 implements InstanceElement2 {
13841382

13851383
/// The superclass of this element.
13861384
///
1387-
/// For [ClassElement] returns `null` only if this class is `Object`. If the
1385+
/// For [ClassElement2] returns `null` only if this class is `Object`. If the
13881386
/// superclass is not explicitly specified, or the superclass cannot be
13891387
/// resolved, then the implicit superclass `Object` is returned.
13901388
///
1391-
/// For [EnumElement] returns `Enum` from `dart:core`.
1389+
/// For [EnumElement2] returns `Enum` from `dart:core`.
13921390
///
1393-
/// For [MixinElement] always returns `null`.
1391+
/// For [MixinElement2] always returns `null`.
13941392
///
13951393
/// <b>Note:</b> Because the element model represents the state of the code,
13961394
/// it is possible for it to be semantically invalid. In particular, it is not
@@ -1756,7 +1754,7 @@ abstract class LibraryExport implements ElementDirective {
17561754
/// The combinators are in the order in which they were specified.
17571755
List<NamespaceCombinator> get combinators;
17581756

1759-
/// The [LibraryElement], if [uri] is a [DirectiveUriWithLibrary].
1757+
/// The [LibraryElement2], if [uri] is a [DirectiveUriWithLibrary].
17601758
LibraryElement2? get exportedLibrary2;
17611759

17621760
/// The offset of the `export` keyword.
@@ -1852,7 +1850,7 @@ abstract class LibraryImport implements ElementDirective {
18521850
/// The combinators are in the order in which they were specified.
18531851
List<NamespaceCombinator> get combinators;
18541852

1855-
/// The [LibraryElement], if [uri] is a [DirectiveUriWithLibrary].
1853+
/// The [LibraryElement2], if [uri] is a [DirectiveUriWithLibrary].
18561854
LibraryElement2? get importedLibrary2;
18571855

18581856
/// The offset of the `import` keyword.
@@ -1875,7 +1873,7 @@ abstract class LibraryImport implements ElementDirective {
18751873
}
18761874

18771875
/// An element that can be (but is not required to be) defined within a method
1878-
/// or function (an [ExecutableElement]).
1876+
/// or function (an [ExecutableFragment]).
18791877
///
18801878
/// Clients may not extend, implement or mix-in this class.
18811879
abstract class LocalElement2 implements Element2 {}
@@ -2379,14 +2377,14 @@ abstract class PropertyAccessorFragment implements ExecutableFragment {
23792377
/// explicitly defined getters and setters. The following rules apply:
23802378
///
23812379
/// * Every explicit variable is represented by a non-synthetic
2382-
/// [PropertyInducingElement].
2383-
/// * Every explicit variable induces a getter and possibly a setter, both of
2384-
/// which are represented by synthetic [PropertyAccessorElement]s.
2385-
/// * Every explicit getter or setter is represented by a non-synthetic
2386-
/// [PropertyAccessorElement].
2380+
/// [PropertyInducingElement2].
2381+
/// * Every explicit variable induces a synthetic [GetterElement],
2382+
/// possibly a synthetic [SetterElement.
2383+
/// * Every explicit getter by a non-synthetic [GetterElement].
2384+
/// * Every explicit setter by a non-synthetic [SetterElement].
23872385
/// * Every explicit getter or setter (or pair thereof if they have the same
23882386
/// name) induces a variable that is represented by a synthetic
2389-
/// [PropertyInducingElement].
2387+
/// [PropertyInducingElement2].
23902388
///
23912389
/// Clients may not extend, implement or mix-in this class.
23922390
abstract class PropertyInducingElement2
@@ -2650,7 +2648,7 @@ abstract class TypeAliasElement2
26502648
TypeDefiningElement2,
26512649
HasSinceSdkVersion {
26522650
/// If the aliased type has structure, return the corresponding element.
2653-
/// For example, it could be [GenericFunctionTypeElement].
2651+
/// For example, it could be [GenericFunctionTypeElement2].
26542652
///
26552653
/// If there is no structure, return `null`.
26562654
Element2? get aliasedElement2;

0 commit comments

Comments
 (0)