diff --git a/pkg/compiler/lib/src/closure.dart b/pkg/compiler/lib/src/closure.dart index d79c7f08b143..45679bff17ed 100644 --- a/pkg/compiler/lib/src/closure.dart +++ b/pkg/compiler/lib/src/closure.dart @@ -341,7 +341,7 @@ class TypeVariableLocal implements Local { } } -/// A local variable used encode the direct (uncaptured) references to [this]. +/// A local variable used to encode the direct (uncaptured) references to `this`. class ThisLocal extends Local { final ClassEntity enclosingClass; diff --git a/pkg/compiler/lib/src/inferrer/type_graph_nodes.dart b/pkg/compiler/lib/src/inferrer/type_graph_nodes.dart index 24de22bcf7be..182f04317c1a 100644 --- a/pkg/compiler/lib/src/inferrer/type_graph_nodes.dart +++ b/pkg/compiler/lib/src/inferrer/type_graph_nodes.dart @@ -1042,7 +1042,8 @@ abstract class CallSiteTypeInformation extends TypeInformation @override String toString() => 'Call site $debugName $type'; - /// Add [this] to the graph being computed by [engine]. + /// Add this [CallSiteTypeInformation] to the graph being computed by + /// [engine]. void addToGraph(InferrerEngine engine); String get debugName => '$callNode'; diff --git a/pkg/compiler/lib/src/inferrer/typemasks/type_mask.dart b/pkg/compiler/lib/src/inferrer/typemasks/type_mask.dart index f56c555f9d5f..e2abf48e25d1 100644 --- a/pkg/compiler/lib/src/inferrer/typemasks/type_mask.dart +++ b/pkg/compiler/lib/src/inferrer/typemasks/type_mask.dart @@ -337,13 +337,13 @@ abstract class TypeMask implements AbstractValue { return 'Unknown type mask $mask.'; } - /// Returns a nullable variant of [this] type mask. + /// Returns a nullable variant of this [TypeMask]. TypeMask nullable() => withFlags(isNullable: true); - /// Returns a non-nullable variant of [this] type mask. + /// Returns a non-nullable variant of this [TypeMask]. TypeMask nonNullable() => withFlags(isNullable: false); - /// Returns a variant of [this] type mask whose value is neither `null` nor + /// Returns a variant of this [TypeMask] whose value is neither `null` nor /// the late sentinel. TypeMask withoutFlags() => withFlags(isNullable: false, hasLateSentinel: false); @@ -359,14 +359,14 @@ abstract class TypeMask implements AbstractValue { /// Whether the only possible value in this mask is Null. bool get isNull; - /// Whether [this] is a sentinel for an uninitialized late variable. + /// Whether this [TypeMask] is a sentinel for an uninitialized late variable. AbstractBool get isLateSentinel; /// Whether a late sentinel is a valid value of this mask. bool get hasLateSentinel => isLateSentinel.isPotentiallyTrue; - /// Whether [this] mask is empty or only represents values tracked by flags - /// (i.e. `null` and the late sentinel). + /// Whether this [TypeMask] is empty or only represents values tracked by + /// flags (i.e. `null` and the late sentinel). bool get isEmptyOrFlagged; /// Whether this mask only includes instances of an exact class, and none of @@ -411,13 +411,15 @@ abstract class TypeMask implements AbstractValue { /// otherwise returns `null`. This method is conservative. ClassEntity? singleClass(JClosedWorld closedWorld); - /// Returns a type mask representing the union of [this] and [other]. + /// Returns a type mask representing the union of this [TypeMask] and + /// [other]. TypeMask union(TypeMask other, CommonMasks domain); /// Returns whether the intersection of this and [other] is empty. bool isDisjoint(TypeMask other, JClosedWorld closedWorld); - /// Returns a type mask representing the intersection of [this] and [other]. + /// Returns a type mask representing the intersection of this [TypeMask] and + /// [other]. TypeMask intersection(TypeMask other, CommonMasks domain); /// Returns whether [element] is a potential target when being invoked on this diff --git a/pkg/compiler/lib/src/ssa/optimize.dart b/pkg/compiler/lib/src/ssa/optimize.dart index c2ded41424e9..62984c04d1c0 100644 --- a/pkg/compiler/lib/src/ssa/optimize.dart +++ b/pkg/compiler/lib/src/ssa/optimize.dart @@ -4254,7 +4254,8 @@ class MemorySet { } } - /// Returns the intersection between [this] and the [other] memory set. + /// Returns the intersection between this [MemorySet] and the [other] memory + /// set. MemorySet intersectionFor( MemorySet? other, HBasicBlock block, int predecessorIndex) { MemorySet result = MemorySet(closedWorld); @@ -4335,7 +4336,7 @@ class MemorySet { return result; } - /// Returns a copy of [this] memory set. + /// Returns a copy of this [MemorySet]. MemorySet clone() { MemorySet result = MemorySet(closedWorld); @@ -4351,7 +4352,7 @@ class MemorySet { return result; } - /// Returns a copy of [this] memory set, removing any expressions that are not + /// Returns a copy of this [MemorySet], removing any expressions that are not /// valid in [block]. MemorySet cloneIfDominatesBlock(HBasicBlock block) { bool instructionDominatesBlock(HInstruction? instruction) { diff --git a/pkg/compiler/lib/src/universe/selector.dart b/pkg/compiler/lib/src/universe/selector.dart index bf38b34086a1..32f99fc06d56 100644 --- a/pkg/compiler/lib/src/universe/selector.dart +++ b/pkg/compiler/lib/src/universe/selector.dart @@ -239,7 +239,8 @@ class Selector { return signatureApplies(element as FunctionEntity); } - /// Whether [this] could be a valid selector on `Null` without throwing. + /// Whether this [Selector] could be a valid selector on `Null` without + /// throwing. bool appliesToNullWithoutThrow() { var name = this.name; if (isOperator && name == "==") return true;