diff --git a/packages/flutter/lib/src/foundation/debug.dart b/packages/flutter/lib/src/foundation/debug.dart index b8e526cd5d..1f6854aa78 100644 --- a/packages/flutter/lib/src/foundation/debug.dart +++ b/packages/flutter/lib/src/foundation/debug.dart @@ -63,8 +63,13 @@ Future debugInstrumentAction(String description, Future action()) { } } -/// Arguments to whitelist [Timeline] events in order to be shown in the -/// developer centric version of the Observatory Timeline. +/// Argument passed to [Timeline] events in order to cause those events to be +/// shown in the developer-centric version of the Observatory Timeline. +/// +/// See also: +/// +/// * [Timeline.startSync], which typically takes this value as its `arguments` +/// argument. const Map timelineWhitelistArguments = { 'mode': 'basic' }; diff --git a/packages/flutter/lib/src/gestures/hit_test.dart b/packages/flutter/lib/src/gestures/hit_test.dart index df45811683..e2be1dba9c 100644 --- a/packages/flutter/lib/src/gestures/hit_test.dart +++ b/packages/flutter/lib/src/gestures/hit_test.dart @@ -66,7 +66,7 @@ class HitTestResult { /// The first entry in the path is the most specific, typically the one at /// the leaf of tree being hit tested. Event propagation starts with the most /// specific (i.e., first) entry and proceeds in order through the path. - List get path => List.unmodifiable(_path); + Iterable get path => _path; final List _path; /// Add a [HitTestEntry] to the path. diff --git a/packages/flutter/lib/src/gestures/scale.dart b/packages/flutter/lib/src/gestures/scale.dart index e381a4bb30..441260f5e0 100644 --- a/packages/flutter/lib/src/gestures/scale.dart +++ b/packages/flutter/lib/src/gestures/scale.dart @@ -140,10 +140,10 @@ class _LineBetweenPointers{ /// Recognizes a scale gesture. /// /// [ScaleGestureRecognizer] tracks the pointers in contact with the screen and -/// calculates their focal point, indicated scale and rotation. When a focal pointer is -/// established, the recognizer calls [onStart]. As the focal point, scale, rotation -/// change, the recognizer calls [onUpdate]. When the pointers are no longer in -/// contact with the screen, the recognizer calls [onEnd]. +/// calculates their focal point, indicated scale, and rotation. When a focal +/// pointer is established, the recognizer calls [onStart]. As the focal point, +/// scale, rotation change, the recognizer calls [onUpdate]. When the pointers +/// are no longer in contact with the screen, the recognizer calls [onEnd]. class ScaleGestureRecognizer extends OneSequenceGestureRecognizer { /// Create a gesture recognizer for interactions intended for scaling content. ScaleGestureRecognizer({ Object debugOwner }) : super(debugOwner: debugOwner); diff --git a/packages/flutter/lib/src/widgets/spacer.dart b/packages/flutter/lib/src/widgets/spacer.dart index dc7fea1149..8c8e5a2010 100644 --- a/packages/flutter/lib/src/widgets/spacer.dart +++ b/packages/flutter/lib/src/widgets/spacer.dart @@ -14,8 +14,8 @@ import 'framework.dart'; /// [Flex.mainAxisAlignment] on a flex container that contains a [Spacer] to /// [MainAxisAlignment.spaceAround], [MainAxisAlignment.spaceBetween], or /// [MainAxisAlignment.spaceEvenly] will not have any visible effect: the -/// [Spacer] has taken up all of the additional space, so there is none left to -/// redistribute. +/// [Spacer] has taken up all of the additional space, therefore there is none +/// left to redistribute. /// /// ## Sample code /// @@ -59,10 +59,7 @@ class Spacer extends StatelessWidget { Widget build(BuildContext context) { return Expanded( flex: flex, - child: const SizedBox( - height: 0.0, - width: 0.0, - ), + child: const SizedBox.shrink(), ); } }