diff --git a/analysis_options.yaml b/analysis_options.yaml index 54dd548c503c2a..6cf021a7e683e0 100644 --- a/analysis_options.yaml +++ b/analysis_options.yaml @@ -208,7 +208,7 @@ linter: - type_init_formals - type_literal_in_constant_pattern # - unawaited_futures # too many false positives, especially with the way AnimationController works - # - unintended_html_in_doc_comment # not yet tested + # - unintended_html_in_doc_comment # blocked on https://github.com/dart-lang/linter/issues/5065 - unnecessary_await_in_return - unnecessary_brace_in_string_interps - unnecessary_breaks diff --git a/packages/flutter/lib/src/painting/image_resolution.dart b/packages/flutter/lib/src/painting/image_resolution.dart index ec18d48ff7bd55..4039a2c29a0488 100644 --- a/packages/flutter/lib/src/painting/image_resolution.dart +++ b/packages/flutter/lib/src/painting/image_resolution.dart @@ -252,7 +252,7 @@ class AssetImage extends AssetBundleImageProvider { /// The name used to generate the key to obtain the asset. For local assets /// this is [assetName], and for assets from packages the [assetName] is - /// prefixed 'packages//'. + /// prefixed `packages//`. String get keyName => package == null ? assetName : 'packages/$package/$assetName'; /// The bundle from which the image will be obtained. diff --git a/packages/flutter/lib/src/painting/linear_border.dart b/packages/flutter/lib/src/painting/linear_border.dart index 69a66dc51391b2..897410059a59af 100644 --- a/packages/flutter/lib/src/painting/linear_border.dart +++ b/packages/flutter/lib/src/painting/linear_border.dart @@ -13,7 +13,7 @@ import 'basic_types.dart'; import 'borders.dart'; import 'edge_insets.dart'; -/// Defines the relative size and alignment of one edge. +/// Defines the relative size and alignment of one [LinearBorder] edge. /// /// A [LinearBorder] defines a box outline as zero to four edges, each /// of which is rendered as a single line. The width and color of the diff --git a/packages/flutter/lib/src/semantics/semantics.dart b/packages/flutter/lib/src/semantics/semantics.dart index a7e5ea75a072e5..d3516781ee3e1a 100644 --- a/packages/flutter/lib/src/semantics/semantics.dart +++ b/packages/flutter/lib/src/semantics/semantics.dart @@ -1642,7 +1642,7 @@ class SemanticsProperties extends DiagnosticableTree { /// This handler is invoked when the user wants to replace the current text in /// the text field with a new text. /// - /// Voice access users can trigger this handler by speaking "type " to + /// Voice access users can trigger this handler by speaking `type ` to /// their Android devices. final SetTextHandler? onSetText; @@ -4111,7 +4111,7 @@ class SemanticsConfiguration { /// This handler is invoked when the user wants to replace the current text in /// the text field with a new text. /// - /// Voice access users can trigger this handler by speaking "type " to + /// Voice access users can trigger this handler by speaking `type ` to /// their Android devices. SetTextHandler? get onSetText => _onSetText; SetTextHandler? _onSetText; diff --git a/packages/flutter/lib/src/widgets/dismissible.dart b/packages/flutter/lib/src/widgets/dismissible.dart index 6603acafe0dae2..192e230a6cf43a 100644 --- a/packages/flutter/lib/src/widgets/dismissible.dart +++ b/packages/flutter/lib/src/widgets/dismissible.dart @@ -136,10 +136,10 @@ class Dismissible extends StatefulWidget { /// /// The widget cannot be dragged again until the returned future resolves. /// - /// If the returned Future completes true, then this widget will be + /// If the returned `Future` completes true, then this widget will be /// dismissed, otherwise it will be moved back to its original location. /// - /// If the returned Future completes to false or null the [onResize] + /// If the returned `Future` completes to false or null the [onResize] /// and [onDismissed] callbacks will not run. final ConfirmDismissCallback? confirmDismiss; diff --git a/packages/flutter/lib/src/widgets/scrollable_helpers.dart b/packages/flutter/lib/src/widgets/scrollable_helpers.dart index cbdc1ac48c7fe8..287536fe401940 100644 --- a/packages/flutter/lib/src/widgets/scrollable_helpers.dart +++ b/packages/flutter/lib/src/widgets/scrollable_helpers.dart @@ -156,7 +156,7 @@ class ScrollableDetails { /// /// The scroll velocity is controlled by the [velocityScalar]: /// -/// velocity = * [velocityScalar]. +/// velocity = (distance of overscroll) * [velocityScalar]. class EdgeDraggingAutoScroller { /// Creates a auto scroller that scrolls the [scrollable]. EdgeDraggingAutoScroller( @@ -179,7 +179,7 @@ class EdgeDraggingAutoScroller { /// The velocity scalar per pixel over scroll. /// /// It represents how the velocity scale with the over scroll distance. The - /// auto-scroll velocity = * velocityScalar. + /// auto-scroll velocity = (distance of overscroll) * velocityScalar. /// {@endtemplate} final double velocityScalar;