github/flutter
7
0
Fork 0
mirror of https://github.com/flutter/flutter.git synced 2025-06-03 00:51:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Remove superfluous words from comments (#119055)

Browse Source 
* Remove superfluous words from comments.

* Revert `win32_window.h`

Which seems to come from `gallery`
This commit is contained in:
Ahmed Ashour 2023-01-25 21:23:24 +01:00 committed by GitHub
parent 0dd63d3310
commit 1fd71de0c5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
28 changed files with 38 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
packages/flutter/lib/src/cupertino/adaptive_text_selection_toolbar.dart
View File

@ -157,7 +157,7 @@ class CupertinoAdaptiveTextSelectionToolbar extends StatelessWidget {
final List<ContextMenuButtonItem>? buttonItems;
/// Returns a List of Widgets generated by turning [buttonItems] into the
/// the default context menu buttons for Cupertino on the current platform.
/// default context menu buttons for Cupertino on the current platform.
///
/// This is useful when building a text selection toolbar with the default
/// button appearance for the given platform, but where the toolbar and/or the
@ -165,7 +165,7 @@ class CupertinoAdaptiveTextSelectionToolbar extends StatelessWidget {
///
/// Does not build Material buttons. On non-Apple platforms, Cupertino buttons
/// will still be used, because the Cupertino library does not access the
/// Material library. To get the native-looking buttons on every platform, use
/// Material library. To get the native-looking buttons on every platform,
/// use [AdaptiveTextSelectionToolbar.getAdaptiveButtons] in the Material
/// library.
///

2
packages/flutter/lib/src/foundation/diagnostics.dart
View File

@ -2561,7 +2561,7 @@ class DiagnosticsProperty<T> extends DiagnosticsNode {
/// The [showName], [showSeparator], [style], [missingIfNull], and [level]
/// arguments must not be null.
///
/// The [level] argument is just a suggestion and can be overridden if
/// The [level] argument is just a suggestion and can be overridden
/// if something else about the property causes it to have a lower or higher
/// level. For example, if calling `computeValue` throws an exception, [level]
/// will always return [DiagnosticLevel.error].

2
packages/flutter/lib/src/gestures/monodrag.dart
View File

@ -180,7 +180,7 @@ abstract class DragGestureRecognizer extends OneSequenceGestureRecognizer {
/// * [allowedButtonsFilter], which decides which button will be allowed.
GestureDragCancelCallback? onCancel;
/// The minimum distance an input pointer drag must have moved to
/// The minimum distance an input pointer drag must have moved
/// to be considered a fling gesture.
///
/// This value is typically compared with the distance traveled along the

2
packages/flutter/lib/src/material/action_chip.dart
View File

@ -20,7 +20,7 @@ import 'theme_data.dart';
/// Action chips can be tapped to trigger an action or show progress and
/// confirmation. For Material 3, a disabled state is supported for Action
/// chips and is specified with [onPressed] being null. For previous versions
/// of Material Design, it is recommended to remove the Action chip from the
/// of Material Design, it is recommended to remove the Action chip from
/// the interface entirely rather than display a disabled chip.
///
/// Action chips are displayed after primary content, such as below a card or

2
packages/flutter/lib/src/material/adaptive_text_selection_toolbar.dart
View File

@ -220,7 +220,7 @@ class AdaptiveTextSelectionToolbar extends StatelessWidget {
}
/// Returns a List of Widgets generated by turning [buttonItems] into the
/// the default context menu buttons for the current platform.
/// default context menu buttons for the current platform.
///
/// This is useful when building a text selection toolbar with the default
/// button appearance for the given platform, but where the toolbar and/or the

8
packages/flutter/lib/src/material/app_bar.dart
View File

@ -129,7 +129,7 @@ class _PreferredAppBarSize extends Size {
///
/// If the app bar's [actions] contains [TextButton]s, they will not
/// be visible if their foreground (text) color is the same as the
/// the app bar's background color.
/// app bar's background color.
///
/// The default app bar [backgroundColor] is the overall theme's
/// [ColorScheme.primary] if the overall theme's brightness is
@ -591,7 +591,7 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget {
/// See also:
///
/// * [actionsIconTheme], which defines the appearance of icons in
/// in the [actions] list.
/// the [actions] list.
final IconThemeData? iconTheme;
/// {@template flutter.material.appbar.actionsIconTheme}
@ -746,7 +746,7 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget {
///
/// * [titleTextStyle], which overrides the default text style for the [title].
/// * [DefaultTextStyle], which overrides the default text style for all of the
/// the widgets in a subtree.
/// widgets in a subtree.
final TextStyle? toolbarTextStyle;
/// {@template flutter.material.appbar.titleTextStyle}
@ -764,7 +764,7 @@ class AppBar extends StatefulWidget implements PreferredSizeWidget {
/// [title], [leading], and [actions] widgets, also known as the
/// AppBar's "toolbar".
/// * [DefaultTextStyle], which overrides the default text style for all of the
/// the widgets in a subtree.
/// widgets in a subtree.
final TextStyle? titleTextStyle;
/// {@template flutter.material.appbar.systemOverlayStyle}

2
packages/flutter/lib/src/material/checkbox.dart
View File

@ -34,7 +34,7 @@ import 'toggleable.dart';
///
/// {@tool dartpad}
/// This example shows how you can override the default theme of
/// of a [Checkbox] with a [MaterialStateProperty].
/// a [Checkbox] with a [MaterialStateProperty].
/// In this example, the checkbox's color will be `Colors.blue` when the [Checkbox]
/// is being pressed, hovered, or focused. Otherwise, the checkbox's color will
/// be `Colors.red`.

2
packages/flutter/lib/src/material/drawer.dart
View File

@ -115,7 +115,7 @@ const Duration _kBaseSettleDuration = Duration(milliseconds: 246);
/// {@end-tool}
///
/// An open drawer may be closed with a swipe to close gesture, pressing the
/// the escape key, by tapping the scrim, or by calling pop route function such as
/// escape key, by tapping the scrim, or by calling pop route function such as
/// [Navigator.pop]. For example a drawer item might close the drawer when tapped:
///
/// ```dart

2
packages/flutter/lib/src/material/flexible_space_bar.dart
View File

@ -116,7 +116,7 @@ class FlexibleSpaceBar extends StatefulWidget {
/// bottom-left or its center.
///
/// Typically this property is used to adjust how far the title is
/// is inset from the bottom-left and it is specified along with
/// inset from the bottom-left and it is specified along with
/// [centerTitle] false.
///
/// By default the value of this property is

2
packages/flutter/lib/src/material/range_slider.dart
View File

@ -326,7 +326,7 @@ class RangeSlider extends StatefulWidget {
/// the range slider thumb is hovered or dragged.
///
/// If this property is null, [RangeSlider] will use [activeColor] with
/// with an opacity of 0.12. If null, [SliderThemeData.overlayColor]
/// an opacity of 0.12. If null, [SliderThemeData.overlayColor]
/// will be used, otherwise defaults to [ColorScheme.primary] with
/// an opacity of 0.12.
final MaterialStateProperty<Color?>? overlayColor;

2
packages/flutter/lib/src/material/slider.dart
View File

@ -431,7 +431,7 @@ class Slider extends StatefulWidget {
/// the slider thumb is focused, hovered, or dragged.
///
/// If this property is null, [Slider] will use [activeColor] with
/// with an opacity of 0.12, If null, [SliderThemeData.overlayColor]
/// an opacity of 0.12, If null, [SliderThemeData.overlayColor]
/// will be used.
///
/// If that is also null, If [ThemeData.useMaterial3] is true,

4
packages/flutter/lib/src/material/snack_bar.dart
View File

@ -96,7 +96,7 @@ class SnackBarAction extends StatefulWidget {
/// [SnackBarThemeData.actionTextColor].
///
/// If [textColor] is a [MaterialStateColor], then the text color will be
/// be resolved against the set of [MaterialState]s that the action text
/// resolved against the set of [MaterialState]s that the action text
/// is in, thus allowing for different colors for states such as pressed,
/// hovered and others.
final Color? textColor;
@ -366,7 +366,7 @@ class SnackBar extends StatefulWidget {
/// inverse surface.
///
/// If [closeIconColor] is a [MaterialStateColor], then the icon color will be
/// be resolved against the set of [MaterialState]s that the action text
/// resolved against the set of [MaterialState]s that the action text
/// is in, thus allowing for different colors for states such as pressed,
/// hovered and others.
final Color? closeIconColor;

6
packages/flutter/lib/src/material/theme_data.dart
View File

@ -1145,7 +1145,7 @@ class ThemeData with Diagnosticable {
/// to determine the current platform for the purpose of emulating the
/// platform behavior (e.g. scrolling or haptic effects). Widgets and render
/// objects at lower layers that try to emulate the underlying platform
/// platform can depend on [defaultTargetPlatform] directly, or may require
/// can depend on [defaultTargetPlatform] directly, or may require
/// that the target platform be provided as an argument. The
/// [dart:io.Platform] object should only be used directly when it's critical
/// to actually know the current platform, without any overrides possible (for
@ -1591,7 +1591,7 @@ class ThemeData with Diagnosticable {
///
/// Apps should migrate uses of this property to the theme's [colorScheme]
/// [ColorScheme.secondary] color. In cases where a color is needed that
/// that contrasts well with the secondary color [ColorScheme.onSecondary]
/// contrasts well with the secondary color [ColorScheme.onSecondary]
/// can be used.
@Deprecated(
'Use colorScheme.secondary instead. '
@ -2539,7 +2539,7 @@ class ThemeData with Diagnosticable {
/// styles.
///
/// In the most basic case, [ThemeData]'s `cupertinoOverrideTheme` is null and
/// and descendant Cupertino widgets' styling is derived from the Material theme.
/// descendant Cupertino widgets' styling is derived from the Material theme.
///
/// To override individual parts of the Material-derived Cupertino styling,
/// `cupertinoOverrideTheme`'s construction parameters can be used.

2
packages/flutter/lib/src/painting/box_shadow.dart
View File

@ -80,7 +80,7 @@ class BoxShadow extends ui.Shadow {
/// Linearly interpolate between two box shadows.
///
/// If either box shadow is null, this function linearly interpolates from a
/// If either box shadow is null, this function linearly interpolates from
/// a box shadow that matches the other box shadow in color but has a zero
/// offset and a zero blurRadius.
///

4
packages/flutter/lib/src/painting/gradient.dart
View File

@ -468,7 +468,7 @@ class LinearGradient extends Gradient {
/// Linearly interpolate between two [LinearGradient]s.
///
/// If either gradient is null, this function linearly interpolates from a
/// If either gradient is null, this function linearly interpolates from
/// a gradient that matches the other gradient in [begin], [end], [stops] and
/// [tileMode] and with the same [colors] but transparent (using [scale]).
///
@ -747,7 +747,7 @@ class RadialGradient extends Gradient {
/// Linearly interpolate between two [RadialGradient]s.
///
/// If either gradient is null, this function linearly interpolates from a
/// If either gradient is null, this function linearly interpolates from
/// a gradient that matches the other gradient in [center], [radius], [stops] and
/// [tileMode] and with the same [colors] but transparent (using [scale]).
///

2
packages/flutter/lib/src/rendering/sliver_multi_box_adaptor.dart
View File

@ -169,7 +169,7 @@ class SliverMultiBoxAdaptorParentData extends SliverLogicalParentData with Conta
/// been laid out during that layout pass.
/// * Children cannot be added except during a call to [childManager], and
/// then only if there is no child corresponding to that index (or the child
/// child corresponding to that index was first removed).
/// corresponding to that index was first removed).
///
/// See also:
///

2
packages/flutter/lib/src/widgets/draggable_scrollable_sheet.dart
View File

@ -317,7 +317,7 @@ class DraggableScrollableSheet extends StatefulWidget {
/// The initial fractional value of the parent container's height to use when
/// displaying the widget.
///
/// Rebuilding the sheet with a new [initialChildSize] will only move the
/// Rebuilding the sheet with a new [initialChildSize] will only move
/// the sheet to the new value if the sheet has not yet been dragged since it
/// was first built or since the last call to [DraggableScrollableActuator.reset].
///

2
packages/flutter/lib/src/widgets/editable_text.dart
View File

@ -3966,7 +3966,7 @@ class EditableTextState extends State<EditableText> with AutomaticKeepAliveClien
// `x ∉ getTextBoundaryAt(x)`. In case `caretOffset` points to one such
// control character, we define that these control characters themselves are
// still part of the previous line, but also exclude them from the
// the line boundary range since they're non-printing. IOW, no additional
// line boundary range since they're non-printing. IOW, no additional
// processing needed since the LineBoundary class does exactly that.
return forward
? TextPosition(offset: textBoundary.getTrailingTextBoundaryAt(caretOffset) ?? _value.text.length, affinity: TextAffinity.upstream)

4
packages/flutter/lib/src/widgets/localizations.dart
View File

@ -318,8 +318,8 @@ class _LocalizationsScope extends InheritedWidget {
/// }
/// ```
///
/// Each delegate can be viewed as a factory for objects that encapsulate a
/// a set of localized resources. These objects are retrieved with
/// Each delegate can be viewed as a factory for objects that encapsulate a set
/// of localized resources. These objects are retrieved with
/// by runtime type with [Localizations.of].
///
/// The [WidgetsApp] class creates a [Localizations] widget so most apps

2
packages/flutter/lib/src/widgets/performance_overlay.dart
View File

@ -59,7 +59,7 @@ class PerformanceOverlay extends LeafRenderObjectWidget {
/// For example, if you want a trace of all pictures that could not be
/// rendered by the rasterizer within the frame boundary (and hence caused
/// jank), specify 1. Specifying 2 will trace all pictures that took more
/// more than 2 frame intervals to render. Adjust this value to only capture
/// than 2 frame intervals to render. Adjust this value to only capture
/// the particularly expensive pictures while skipping the others. Specifying
/// 0 disables all capture.
///

4
packages/flutter/lib/src/widgets/scroll_physics.dart
View File

@ -405,8 +405,8 @@ class ScrollPhysics {
);
}
/// The minimum distance an input pointer drag must have moved to
/// to be considered a scroll fling gesture.
/// The minimum distance an input pointer drag must have moved to be
/// considered a scroll fling gesture.
///
/// This value is typically compared with the distance traveled along the
/// scrolling axis.

2
packages/flutter/test/material/tabs_test.dart
View File

@ -704,7 +704,7 @@ void main() {
}
// End the fling by reversing direction. This should cause not cause
// a change to the selected tab, everything should just settle back to
// to where it started.
// where it started.
for (int index = 0; index > 50; index += 1) {
await gesture.moveBy(const Offset(10.0, 0.0));
await tester.pump(const Duration(milliseconds: 1));

2
packages/flutter/test/material/text_field_test.dart
View File

@ -11039,7 +11039,7 @@ void main() {
expect(
tester.getSize(find.byType(TextField)),
// When the strut fontSize is larger than a provided TextStyle, the
// the strut's height takes precedence.
// strut's height takes precedence.
const Size(800, 78),
);
},

2
packages/flutter/test/physics/newton_test.dart
View File

@ -60,7 +60,7 @@ void main() {
expect(friction.dx(1.0), moreOrLessEquals(endVelocity));
// Same scenario as above except that the velocities are
// are negative.
// negative.
startPosition = 1000.0;
startVelocity = -500.0;
f = FrictionSimulation(0.025, 1000.0, -500.0);

2
packages/flutter_tools/lib/src/base/utils.dart
View File

@ -339,7 +339,7 @@ List<String> _wrapTextAsLines(String text, {
final int effectiveLength = math.max(columnWidth - start, kMinColumnWidth);
for (final String line in text.split('\n')) {
// If the line is short enough, even with ANSI codes, then we can just add
// add it and move on.
// it and move on.
if (line.length <= effectiveLength || !shouldWrap) {
result.add(line);
continue;

2
packages/flutter_tools/lib/src/localizations/message_parser.dart
View File

@ -335,7 +335,7 @@ class Parser {
parsingStack.addAll(grammarRule.reversed);
// For tree construction, add nodes to the parent until the parent has all
// all the children it is expecting.
// the children it is expecting.
parent.children.add(node);
if (parent.isFull) {
treeTraversalStack.removeLast();

2
packages/flutter_tools/lib/src/template.dart
View File

@ -86,7 +86,7 @@ class Template {
from: templateFiles[entity]!.absolute.path);
if (relativePath.contains(templateExtension)) {
// If '.tmpl' appears anywhere within the path of this entity, it is
// is a candidate for rendering. This catches cases where the folder
// a candidate for rendering. This catches cases where the folder
// itself is a template.
_templateFilePaths[relativePath] = fileSystem.path.absolute(entity.path);
}

2
packages/flutter_tools/lib/src/test/web_test_compiler.dart
View File

@ -52,7 +52,7 @@ class WebTestCompiler {
LanguageVersion languageVersion = LanguageVersion(2, 8);
late final String platformDillName;
// TODO(zanderso): to support autodetect this would need to partition the source code into a
// TODO(zanderso): to support autodetect this would need to partition the source code into
// a sound and unsound set and perform separate compilations
final List<String> extraFrontEndOptions = List<String>.of(buildInfo.extraFrontEndOptions);
if (buildInfo.nullSafetyMode == NullSafetyMode.unsound || buildInfo.nullSafetyMode == NullSafetyMode.autodetect) {