diff --git a/flutter_kernel_transformers/lib/track_widget_constructor_locations.dart b/flutter_kernel_transformers/lib/track_widget_constructor_locations.dart index 47fa4f341f826..78c361e98f516 100644 --- a/flutter_kernel_transformers/lib/track_widget_constructor_locations.dart +++ b/flutter_kernel_transformers/lib/track_widget_constructor_locations.dart @@ -144,7 +144,7 @@ class _WidgetCallSiteTransformer extends Transformer { /// locations of the parameters passed in from the source location of the /// constructor call but it is convenient to bundle the location and names /// of the parameters passed in so that tools can show parameter locations - /// without reparsing the source code. + /// without re-parsing the source code. ConstructorInvocation _constructLocation( Location location, { String name, @@ -399,7 +399,7 @@ class WidgetCreatorTracker implements ProgramTransformer { new VariableGet(variable), )); // TODO(jacobr): add an assert verifying the locationField is not - // null. Curently we cannot safely add this assert because we do not + // null. Currently, we cannot safely add this assert because we do not // handle Widget classes with optional positional arguments. There are // no Widget classes in the flutter repo with optional positional // arguments but it is possible users could add classes with optional diff --git a/lib/stub_ui/compositing.dart b/lib/stub_ui/compositing.dart index 3de66280773c9..071b1d45cdacd 100644 --- a/lib/stub_ui/compositing.dart +++ b/lib/stub_ui/compositing.dart @@ -215,7 +215,7 @@ class SceneBuilder { /// Android view: When resizing an Android view there is a short period during /// which the framework cannot tell if the newest texture frame has the /// previous or new size, to workaround this the framework "freezes" the - /// texture just before resizing the Android view and unfreezes it when it is + /// texture just before resizing the Android view and un-freezes it when it is /// certain that a frame with the new size is ready. void addTexture(int textureId, { Offset offset: Offset.zero, double width: 0.0, double height: 0.0 , bool freeze: false}) { throw UnimplementedError(); diff --git a/lib/stub_ui/natives.dart b/lib/stub_ui/natives.dart index d8388a8640e5f..9e46816e5f5b5 100644 --- a/lib/stub_ui/natives.dart +++ b/lib/stub_ui/natives.dart @@ -33,7 +33,7 @@ void _setupHooks() { // ignore: unused_element /// /// The buffer contains a list of symbols compiled by the Dart JIT at runtime up to the point /// when this function was called. This list can be saved to a text file and passed to tools -/// such as `flutter build` or Dart `gen_snapshot` in order to precompile this code offline. +/// such as `flutter build` or Dart `gen_snapshot` in order to pre-compile this code offline. /// /// The list has one symbol per line of the following format: `,,\n`. /// Here are some examples: diff --git a/lib/stub_ui/painting.dart b/lib/stub_ui/painting.dart index 958f4020d0dad..ce60d7bb130df 100644 --- a/lib/stub_ui/painting.dart +++ b/lib/stub_ui/painting.dart @@ -59,7 +59,7 @@ Color _scaleAlpha(Color a, double factor) { /// /// Consider the light teal of the Flutter logo. It is fully opaque, with a red /// channel value of 0x42 (66), a green channel value of 0xA5 (165), and a blue -/// channel value of 0xF5 (245). In the common "hash syntax" for colour values, +/// channel value of 0xF5 (245). In the common "hash syntax" for color values, /// it would be described as `#42A5F5`. /// /// Here are some ways it could be constructed: @@ -803,7 +803,7 @@ enum FilterQuality { /// Fastest possible filtering, albeit also the lowest quality. /// - /// Typically this implies nearest-neighbour filtering. + /// Typically this implies nearest-neighbor filtering. none, /// Better quality than [none], faster than [medium]. @@ -814,7 +814,7 @@ enum FilterQuality { /// Better quality than [low], faster than [high]. /// /// Typically this implies a combination of bilinear interpolation and - /// pyramidal parametric prefiltering (mipmaps). + /// pyramidal parametric pre-filtering (mipmaps). medium, /// Best possible quality filtering, albeit also the slowest. @@ -1651,7 +1651,7 @@ void decodeImageFromList(Uint8List list, ImageDecoderCallback callback) { /// [pixels] is the pixel data in the encoding described by [format]. /// /// [rowBytes] is the number of bytes consumed by each row of pixels in the -/// data buffer. If unspecified, it defaults to [width] multipled by the +/// data buffer. If unspecified, it defaults to [width] multiplied by the /// number of bytes per pixel in the provided [format]. /// /// The [decodedCacheRatioCap] is the default maximum multiple of the compressed @@ -1762,17 +1762,17 @@ class EngineLayer { /// A complex, one-dimensional subset of a plane. /// -/// A path consists of a number of subpaths, and a _current point_. +/// A path consists of a number of sub-paths, and a _current point_. /// -/// Subpaths consist of segments of various types, such as lines, -/// arcs, or beziers. Subpaths can be open or closed, and can +/// Sub-paths consist of segments of various types, such as lines, +/// arcs, or beziers. Sub-paths can be open or closed, and can /// self-intersect. /// -/// Closed subpaths enclose a (possibly discontiguous) region of the +/// Closed sub-paths enclose a (possibly discontiguous) region of the /// plane based on the current [fillType]. /// /// The _current point_ is initially at the origin. After each -/// operation adding a segment to a subpath, the current point is +/// operation adding a segment to a sub-path, the current point is /// updated to the end of that segment. /// /// Paths can be drawn on canvases using [Canvas.drawPath], and can @@ -1798,12 +1798,12 @@ class Path { } - /// Starts a new subpath at the given coordinate. + /// Starts a new sub-path at the given coordinate. void moveTo(double x, double y) { throw UnimplementedError(); } - /// Starts a new subpath at the given offset from the current point. + /// Starts a new sub-path at the given offset from the current point. void relativeMoveTo(double dx, double dy) { throw UnimplementedError(); } @@ -1872,7 +1872,7 @@ class Path { /// If the `forceMoveTo` argument is false, adds a straight line /// segment and an arc segment. /// - /// If the `forceMoveTo` argument is true, starts a new subpath + /// If the `forceMoveTo` argument is true, starts a new sub-path /// consisting of an arc segment. /// /// In either case, the arc segment consists of the arc that follows @@ -1936,14 +1936,14 @@ class Path { throw UnimplementedError(); } - /// Adds a new subpath that consists of four lines that outline the + /// Adds a new sub-path that consists of four lines that outline the /// given rectangle. void addRect(Rect rect) { assert(_rectIsValid(rect)); throw UnimplementedError(); } - /// Adds a new subpath that consists of a curve that forms the + /// Adds a new sub-path that consists of a curve that forms the /// ellipse that fills the given rectangle. /// /// To add a circle, pass an appropriate rectangle as `oval`. [Rect.fromCircle] @@ -1953,7 +1953,7 @@ class Path { throw UnimplementedError(); } - /// Adds a new subpath with one arc segment that consists of the arc + /// Adds a new sub-path with one arc segment that consists of the arc /// that follows the edge of the oval bounded by the given /// rectangle, from startAngle radians around the oval up to /// startAngle + sweepAngle radians around the oval, with zero @@ -1967,7 +1967,7 @@ class Path { } - /// Adds a new subpath with a sequence of line segments that connect the given + /// Adds a new sub-path with a sequence of line segments that connect the given /// points. /// /// If `close` is true, a final line segment will be added that connects the @@ -1979,7 +1979,7 @@ class Path { throw UnimplementedError(); } - /// Adds a new subpath that consists of the straight lines and + /// Adds a new sub-path that consists of the straight lines and /// curves needed to form the rounded rectangle described by the /// argument. void addRRect(RRect rrect) { @@ -1987,7 +1987,7 @@ class Path { throw UnimplementedError(); } - /// Adds a new subpath that consists of the given `path` offset by the given + /// Adds a new sub-path that consists of the given `path` offset by the given /// `offset`. /// /// If `matrix4` is specified, the path will be transformed by this matrix @@ -2011,13 +2011,13 @@ class Path { throw UnimplementedError(); } - /// Closes the last subpath, as if a straight line had been drawn - /// from the current point to the first point of the subpath. + /// Closes the last sub-path, as if a straight line had been drawn + /// from the current point to the first point of the sub-path. void close() { throw UnimplementedError(); } - /// Clears the [Path] object of all subpaths, returning it to the + /// Clears the [Path] object of all sub-paths, returning it to the /// same state it had when it was created. The _current point_ is /// reset to the origin. void reset() { @@ -2037,14 +2037,14 @@ class Path { } /// Returns a copy of the path with all the segments of every - /// subpath translated by the given offset. + /// sub-path translated by the given offset. Path shift(Offset offset) { assert(_offsetIsValid(offset)); throw UnimplementedError(); } /// Returns a copy of the path with all the segments of every - /// subpath transformed by the given matrix. + /// sub-path transformed by the given matrix. Path transform(Float64List matrix4) { assert(_matrix4IsValid(matrix4)); throw UnimplementedError(); @@ -2174,7 +2174,7 @@ class PathMetricIterator implements Iterator { } } -/// Utilities for measuring a [Path] and extracting subpaths. +/// Utilities for measuring a [Path] and extracting sub-paths. /// /// Iterate over the object returned by [Path.computeMetrics] to obtain /// [PathMetric] objects. @@ -2220,7 +2220,7 @@ class PathMetric { final _PathMeasure _measure; - /// Computes the position of hte current contour at the given offset, and the + /// Computes the position of the current contour at the given offset, and the /// angle of the path at that point. /// /// For example, calling this method with a distance of 1.41 for a line from @@ -2386,7 +2386,7 @@ class ColorFilter { _matrix = matrix, _type = _TypeMatrix; - /// Construct a color filter that applies the srgb gamma curve to the RGB + /// Construct a color filter that applies the sRGB gamma curve to the RGB /// channels. const ColorFilter.linearToSrgbGamma() : _color = null, @@ -2394,7 +2394,7 @@ class ColorFilter { _matrix = null, _type = _TypeLinearToSrgbGamma; - /// Creates a color filter that applies the inverse of the srgb gamma curve + /// Creates a color filter that applies the inverse of the sRGB gamma curve /// to the RGB channels. const ColorFilter.srgbToLinearGamma() : _color = null, @@ -2811,8 +2811,8 @@ class Canvas { /// ## Using saveLayer with clips /// /// When a rectangular clip operation (from [clipRect]) is not axis-aligned - /// with the raster buffer, or when the clip operation is not rectalinear (e.g. - /// because it is a rounded rectangle clip created by [clipRRect] or an + /// with the raster buffer, or when the clip operation is not rectilinear + /// (e.g. because it is a rounded rectangle clip created by [clipRRect] or an /// arbitrarily complicated path clip created by [clipPath]), the edge of the /// clip needs to be anti-aliased. /// @@ -3103,7 +3103,7 @@ class Canvas { /// Draws the given [Path] with the given [Paint]. Whether this shape is /// filled or stroked (or both) is controlled by [Paint.style]. If the path is - /// filled, then subpaths within it are implicitly closed (see [Path.close]). + /// filled, then sub-paths within it are implicitly closed (see [Path.close]). void drawPath(Path path, Paint paint) { assert(path != null); // path is checked on the engine side assert(paint != null); @@ -3368,7 +3368,7 @@ class Shadow { /// /// The default shadow is a black shadow with zero offset and zero blur. /// Default shadows should be completely covered by the casting element, - /// and not be visble. + /// and not be visible. /// /// Transparency should be adjusted through the [color] alpha. /// @@ -3421,9 +3421,10 @@ class Shadow { /// To honor this as well, the shape should be translated by [offset] before /// being filled using this [Paint]. /// - /// This class does not provide a way to disable shadows to avoid inconsistencies - /// in shadow blur rendering, primarily as a method of reducing test flakiness. - /// [toPaint] should be overriden in subclasses to provide this functionality. + /// This class does not provide a way to disable shadows to avoid + /// inconsistencies in shadow blur rendering, primarily as a method of + /// reducing test flakiness. [toPaint] should be overridden in subclasses to + /// provide this functionality. Paint toPaint() { throw UnimplementedError(); } diff --git a/lib/stub_ui/semantics.dart b/lib/stub_ui/semantics.dart index 6f052f3851a21..bc15a4cc285ac 100644 --- a/lib/stub_ui/semantics.dart +++ b/lib/stub_ui/semantics.dart @@ -161,7 +161,7 @@ class SemanticsAction { /// A [Snackbar], for example, may have a dismiss action to indicate to the /// user that it can be removed after it is no longer relevant. On Android, /// (with TalkBack) special hint text is spoken when focusing the node and - /// a custom action is availible in the local context menu. On iOS, + /// a custom action is available in the local context menu. On iOS, /// (with VoiceOver) users can perform a standard gesture to dismiss it. static const SemanticsAction dismiss = const SemanticsAction._(_kDismissIndex); @@ -642,7 +642,7 @@ class SemanticsUpdateBuilder { /// Update the custom semantics action associated with the given `id`. /// - /// The name of the action exposed to the user is the `label`. For overriden + /// The name of the action exposed to the user is the `label`. For overridden /// standard actions this value is ignored. /// /// The `hint` should describe what happens when an action occurs, not the @@ -652,9 +652,9 @@ class SemanticsUpdateBuilder { /// The text direction of the `hint` and `label` is the same as the global /// window. /// - /// For overriden standard actions, `overrideId` corresponds with a - /// [SemanticsAction.index] value. For custom actions this argument should not be - /// provided. + /// For overridden standard actions, `overrideId` corresponds with a + /// [SemanticsAction.index] value. For custom actions this argument should not + /// be provided. void updateCustomAction({int id, String label, String hint, int overrideId = -1}) { assert(id != null); assert(overrideId != null); diff --git a/lib/stub_ui/text.dart b/lib/stub_ui/text.dart index 6b0fd57a16ad6..bc152addb837a 100644 --- a/lib/stub_ui/text.dart +++ b/lib/stub_ui/text.dart @@ -358,7 +358,7 @@ class TextStyle { /// * `fontWeight`: The typeface thickness to use when painting the text (e.g., bold). /// * `fontStyle`: The typeface variant to use when drawing the letters (e.g., italics). /// * `fontFamily`: The name of the font to use when painting the text (e.g., Roboto). If a `fontFamilyFallback` is - /// provided and `fontFamily` is not, then the first font family in `fontFamilyFallback` will take the postion of + /// provided and `fontFamily` is not, then the first font family in `fontFamilyFallback` will take the position of /// the preferred font family. When a higher priority font cannot be found or does not contain a glyph, a lower /// priority font will be used. /// * `fontFamilyFallback`: An ordered list of the names of the fonts to fallback on when a glyph cannot @@ -1163,7 +1163,7 @@ class TextPosition { /// The only constraint that can be specified is the [width]. See the discussion /// at [width] for more details. class ParagraphConstraints { - /// Creates constraints for laying out a pargraph. + /// Creates constraints for laying out a paragraph. /// /// The [width] argument must not be null. const ParagraphConstraints({ @@ -1372,7 +1372,7 @@ class Paragraph { /// Builds a [Paragraph] containing text with the given styling information. /// -/// To set the paragraph's alignment, truncation, and ellipsising behavior, pass +/// To set the paragraph's alignment, truncation, and ellipsizing behavior, pass /// an appropriately-configured [ParagraphStyle] object to the [new /// ParagraphBuilder] constructor. /// diff --git a/lib/ui/compositing.dart b/lib/ui/compositing.dart index 2647729163430..e7675c0a26e74 100644 --- a/lib/ui/compositing.dart +++ b/lib/ui/compositing.dart @@ -264,7 +264,7 @@ class SceneBuilder extends NativeFieldWrapperClass2 { /// Android view: When resizing an Android view there is a short period during /// which the framework cannot tell if the newest texture frame has the /// previous or new size, to workaround this the framework "freezes" the - /// texture just before resizing the Android view and unfreezes it when it is + /// texture just before resizing the Android view and un-freezes it when it is /// certain that a frame with the new size is ready. void addTexture(int textureId, { Offset offset: Offset.zero, double width: 0.0, double height: 0.0 , bool freeze: false}) { assert(offset != null, 'Offset argument was null'); diff --git a/lib/ui/natives.dart b/lib/ui/natives.dart index 1e9a0798f96f6..27913bdd9a519 100644 --- a/lib/ui/natives.dart +++ b/lib/ui/natives.dart @@ -40,11 +40,14 @@ void _setupHooks() { // ignore: unused_element /// Returns runtime Dart compilation trace as a UTF-8 encoded memory buffer. /// -/// The buffer contains a list of symbols compiled by the Dart JIT at runtime up to the point -/// when this function was called. This list can be saved to a text file and passed to tools -/// such as `flutter build` or Dart `gen_snapshot` in order to precompile this code offline. +/// The buffer contains a list of symbols compiled by the Dart JIT at runtime up +/// to the point when this function was called. This list can be saved to a text +/// file and passed to tools such as `flutter build` or Dart `gen_snapshot` in +/// order to pre-compile this code offline. +/// +/// The list has one symbol per line of the following format: +/// `,,\n`. /// -/// The list has one symbol per line of the following format: `,,\n`. /// Here are some examples: /// /// ``` diff --git a/lib/ui/painting.dart b/lib/ui/painting.dart index 53fb922288a86..a83cf9265d012 100644 --- a/lib/ui/painting.dart +++ b/lib/ui/painting.dart @@ -59,7 +59,7 @@ Color _scaleAlpha(Color a, double factor) { /// /// Consider the light teal of the Flutter logo. It is fully opaque, with a red /// channel value of 0x42 (66), a green channel value of 0xA5 (165), and a blue -/// channel value of 0xF5 (245). In the common "hash syntax" for colour values, +/// channel value of 0xF5 (245). In the common "hash syntax" for color values, /// it would be described as `#42A5F5`. /// /// Here are some ways it could be constructed: @@ -803,7 +803,7 @@ enum FilterQuality { /// Fastest possible filtering, albeit also the lowest quality. /// - /// Typically this implies nearest-neighbour filtering. + /// Typically this implies nearest-neighbor filtering. none, /// Better quality than [none], faster than [medium]. @@ -814,7 +814,7 @@ enum FilterQuality { /// Better quality than [low], faster than [high]. /// /// Typically this implies a combination of bilinear interpolation and - /// pyramidal parametric prefiltering (mipmaps). + /// pyramidal parametric pre-filtering (mipmaps). medium, /// Best possible quality filtering, albeit also the slowest. @@ -1681,7 +1681,7 @@ Future _decodeImageFromListAsync(Uint8List list, /// [pixels] is the pixel data in the encoding described by [format]. /// /// [rowBytes] is the number of bytes consumed by each row of pixels in the -/// data buffer. If unspecified, it defaults to [width] multipled by the +/// data buffer. If unspecified, it defaults to [width] multiplied by the /// number of bytes per pixel in the provided [format]. /// /// The [decodedCacheRatioCap] is the default maximum multiple of the compressed @@ -1799,17 +1799,17 @@ class EngineLayer extends NativeFieldWrapperClass2 { /// A complex, one-dimensional subset of a plane. /// -/// A path consists of a number of subpaths, and a _current point_. +/// A path consists of a number of sub-paths, and a _current point_. /// -/// Subpaths consist of segments of various types, such as lines, -/// arcs, or beziers. Subpaths can be open or closed, and can +/// Sub-paths consist of segments of various types, such as lines, +/// arcs, or beziers. Sub-paths can be open or closed, and can /// self-intersect. /// -/// Closed subpaths enclose a (possibly discontiguous) region of the +/// Closed sub-paths enclose a (possibly discontiguous) region of the /// plane based on the current [fillType]. /// /// The _current point_ is initially at the origin. After each -/// operation adding a segment to a subpath, the current point is +/// operation adding a segment to a sub-path, the current point is /// updated to the end of that segment. /// /// Paths can be drawn on canvases using [Canvas.drawPath], and can @@ -1839,10 +1839,10 @@ class Path extends NativeFieldWrapperClass2 { int _getFillType() native 'Path_getFillType'; void _setFillType(int fillType) native 'Path_setFillType'; - /// Starts a new subpath at the given coordinate. + /// Starts a new sub-path at the given coordinate. void moveTo(double x, double y) native 'Path_moveTo'; - /// Starts a new subpath at the given offset from the current point. + /// Starts a new sub-path at the given offset from the current point. void relativeMoveTo(double dx, double dy) native 'Path_relativeMoveTo'; /// Adds a straight line segment from the current point to the given @@ -1893,7 +1893,7 @@ class Path extends NativeFieldWrapperClass2 { /// If the `forceMoveTo` argument is false, adds a straight line /// segment and an arc segment. /// - /// If the `forceMoveTo` argument is true, starts a new subpath + /// If the `forceMoveTo` argument is true, starts a new sub-path /// consisting of an arc segment. /// /// In either case, the arc segment consists of the arc that follows @@ -1971,7 +1971,7 @@ class Path extends NativeFieldWrapperClass2 { bool largeArc, bool clockwise) native 'Path_relativeArcToPoint'; - /// Adds a new subpath that consists of four lines that outline the + /// Adds a new sub-path that consists of four lines that outline the /// given rectangle. void addRect(Rect rect) { assert(_rectIsValid(rect)); @@ -1979,7 +1979,7 @@ class Path extends NativeFieldWrapperClass2 { } void _addRect(double left, double top, double right, double bottom) native 'Path_addRect'; - /// Adds a new subpath that consists of a curve that forms the + /// Adds a new sub-path that consists of a curve that forms the /// ellipse that fills the given rectangle. /// /// To add a circle, pass an appropriate rectangle as `oval`. [Rect.fromCircle] @@ -1990,7 +1990,7 @@ class Path extends NativeFieldWrapperClass2 { } void _addOval(double left, double top, double right, double bottom) native 'Path_addOval'; - /// Adds a new subpath with one arc segment that consists of the arc + /// Adds a new sub-path with one arc segment that consists of the arc /// that follows the edge of the oval bounded by the given /// rectangle, from startAngle radians around the oval up to /// startAngle + sweepAngle radians around the oval, with zero @@ -2005,7 +2005,7 @@ class Path extends NativeFieldWrapperClass2 { void _addArc(double left, double top, double right, double bottom, double startAngle, double sweepAngle) native 'Path_addArc'; - /// Adds a new subpath with a sequence of line segments that connect the given + /// Adds a new sub-path with a sequence of line segments that connect the given /// points. /// /// If `close` is true, a final line segment will be added that connects the @@ -2018,7 +2018,7 @@ class Path extends NativeFieldWrapperClass2 { } void _addPolygon(Float32List points, bool close) native 'Path_addPolygon'; - /// Adds a new subpath that consists of the straight lines and + /// Adds a new sub-path that consists of the straight lines and /// curves needed to form the rounded rectangle described by the /// argument. void addRRect(RRect rrect) { @@ -2027,7 +2027,7 @@ class Path extends NativeFieldWrapperClass2 { } void _addRRect(Float32List rrect) native 'Path_addRRect'; - /// Adds a new subpath that consists of the given `path` offset by the given + /// Adds a new sub-path that consists of the given `path` offset by the given /// `offset`. /// /// If `matrix4` is specified, the path will be transformed by this matrix @@ -2065,11 +2065,11 @@ class Path extends NativeFieldWrapperClass2 { void _extendWithPath(Path path, double dx, double dy) native 'Path_extendWithPath'; void _extendWithPathAndMatrix(Path path, double dx, double dy, Float64List matrix) native 'Path_extendWithPathAndMatrix'; - /// Closes the last subpath, as if a straight line had been drawn - /// from the current point to the first point of the subpath. + /// Closes the last sub-path, as if a straight line had been drawn + /// from the current point to the first point of the sub-path. void close() native 'Path_close'; - /// Clears the [Path] object of all subpaths, returning it to the + /// Clears the [Path] object of all sub-paths, returning it to the /// same state it had when it was created. The _current point_ is /// reset to the origin. void reset() native 'Path_reset'; @@ -2088,7 +2088,7 @@ class Path extends NativeFieldWrapperClass2 { bool _contains(double x, double y) native 'Path_contains'; /// Returns a copy of the path with all the segments of every - /// subpath translated by the given offset. + /// sub-path translated by the given offset. Path shift(Offset offset) { assert(_offsetIsValid(offset)); return _shift(offset.dx, offset.dy); @@ -2096,7 +2096,7 @@ class Path extends NativeFieldWrapperClass2 { Path _shift(double dx, double dy) native 'Path_shift'; /// Returns a copy of the path with all the segments of every - /// subpath transformed by the given matrix. + /// sub-path transformed by the given matrix. Path transform(Float64List matrix4) { assert(_matrix4IsValid(matrix4)); return _transform(matrix4); @@ -2243,14 +2243,14 @@ class PathMetricIterator implements Iterator { } } -/// Utilities for measuring a [Path] and extracting subpaths. +/// Utilities for measuring a [Path] and extracting sub-paths. /// /// Iterate over the object returned by [Path.computeMetrics] to obtain /// [PathMetric] objects. /// /// Once created, the methods on this class will only be valid while the /// iterator is at the contour for which they were created. It will also only be -/// valid for the path as it was specifed when [Path.computeMetrics] was called. +/// valid for the path as it was specified when [Path.computeMetrics] was called. /// If additional contours are added or any contours are updated, the metrics /// need to be recomputed. class PathMetric { @@ -2288,7 +2288,7 @@ class PathMetric { final _PathMeasure _measure; - /// Computes the position of hte current contour at the given offset, and the + /// Computes the position of the current contour at the given offset, and the /// angle of the path at that point. /// /// For example, calling this method with a distance of 1.41 for a line from @@ -2483,7 +2483,7 @@ class ColorFilter { _matrix = matrix, _type = _TypeMatrix; - /// Construct a color filter that applies the srgb gamma curve to the RGB + /// Construct a color filter that applies the sRGB gamma curve to the RGB /// channels. const ColorFilter.linearToSrgbGamma() : _color = null, @@ -2491,7 +2491,7 @@ class ColorFilter { _matrix = null, _type = _TypeLinearToSrgbGamma; - /// Creates a color filter that applies the inverse of the srgb gamma curve + /// Creates a color filter that applies the inverse of the sRGB gamma curve /// to the RGB channels. const ColorFilter.srgbToLinearGamma() : _color = null, @@ -3055,8 +3055,8 @@ class Canvas extends NativeFieldWrapperClass2 { /// ## Using saveLayer with clips /// /// When a rectangular clip operation (from [clipRect]) is not axis-aligned - /// with the raster buffer, or when the clip operation is not rectalinear (e.g. - /// because it is a rounded rectangle clip created by [clipRRect] or an + /// with the raster buffer, or when the clip operation is not rectilinear + /// (e.g. because it is a rounded rectangle clip created by [clipRRect] or an /// arbitrarily complicated path clip created by [clipPath]), the edge of the /// clip needs to be anti-aliased. /// @@ -3408,7 +3408,7 @@ class Canvas extends NativeFieldWrapperClass2 { /// Draws the given [Path] with the given [Paint]. Whether this shape is /// filled or stroked (or both) is controlled by [Paint.style]. If the path is - /// filled, then subpaths within it are implicitly closed (see [Path.close]). + /// filled, then sub-paths within it are implicitly closed (see [Path.close]). void drawPath(Path path, Paint paint) { assert(path != null); // path is checked on the engine side assert(paint != null); @@ -3803,7 +3803,7 @@ class Shadow { /// /// The default shadow is a black shadow with zero offset and zero blur. /// Default shadows should be completely covered by the casting element, - /// and not be visble. + /// and not be visible. /// /// Transparency should be adjusted through the [color] alpha. /// @@ -3862,9 +3862,10 @@ class Shadow { /// To honor this as well, the shape should be translated by [offset] before /// being filled using this [Paint]. /// - /// This class does not provide a way to disable shadows to avoid inconsistencies - /// in shadow blur rendering, primarily as a method of reducing test flakiness. - /// [toPaint] should be overriden in subclasses to provide this functionality. + /// This class does not provide a way to disable shadows to avoid + /// inconsistencies in shadow blur rendering, primarily as a method of + /// reducing test flakiness. [toPaint] should be overridden in subclasses to + /// provide this functionality. Paint toPaint() { return Paint() ..color = color diff --git a/lib/ui/semantics.dart b/lib/ui/semantics.dart index 5d54eabf67957..1e3650910d543 100644 --- a/lib/ui/semantics.dart +++ b/lib/ui/semantics.dart @@ -164,7 +164,7 @@ class SemanticsAction { /// A [Snackbar], for example, may have a dismiss action to indicate to the /// user that it can be removed after it is no longer relevant. On Android, /// (with TalkBack) special hint text is spoken when focusing the node and - /// a custom action is availible in the local context menu. On iOS, + /// a custom action is available in the local context menu. On iOS, /// (with VoiceOver) users can perform a standard gesture to dismiss it. static const SemanticsAction dismiss = const SemanticsAction._(_kDismissIndex); @@ -708,7 +708,7 @@ class SemanticsUpdateBuilder extends NativeFieldWrapperClass2 { /// Update the custom semantics action associated with the given `id`. /// - /// The name of the action exposed to the user is the `label`. For overriden + /// The name of the action exposed to the user is the `label`. For overridden /// standard actions this value is ignored. /// /// The `hint` should describe what happens when an action occurs, not the @@ -718,7 +718,7 @@ class SemanticsUpdateBuilder extends NativeFieldWrapperClass2 { /// The text direction of the `hint` and `label` is the same as the global /// window. /// - /// For overriden standard actions, `overrideId` corresponds with a + /// For overridden standard actions, `overrideId` corresponds with a /// [SemanticsAction.index] value. For custom actions this argument should not be /// provided. void updateCustomAction({int id, String label, String hint, int overrideId = -1}) { diff --git a/lib/ui/text.dart b/lib/ui/text.dart index 61d4d6afe9c12..1eff826ad2c6c 100644 --- a/lib/ui/text.dart +++ b/lib/ui/text.dart @@ -358,7 +358,7 @@ class TextStyle { /// * `fontWeight`: The typeface thickness to use when painting the text (e.g., bold). /// * `fontStyle`: The typeface variant to use when drawing the letters (e.g., italics). /// * `fontFamily`: The name of the font to use when painting the text (e.g., Roboto). If a `fontFamilyFallback` is - /// provided and `fontFamily` is not, then the first font family in `fontFamilyFallback` will take the postion of + /// provided and `fontFamily` is not, then the first font family in `fontFamilyFallback` will take the position of /// the preferred font family. When a higher priority font cannot be found or does not contain a glyph, a lower /// priority font will be used. /// * `fontFamilyFallback`: An ordered list of the names of the fonts to fallback on when a glyph cannot @@ -1165,7 +1165,7 @@ class TextPosition { /// The only constraint that can be specified is the [width]. See the discussion /// at [width] for more details. class ParagraphConstraints { - /// Creates constraints for laying out a pargraph. + /// Creates constraints for laying out a paragraph. /// /// The [width] argument must not be null. const ParagraphConstraints({ @@ -1370,7 +1370,7 @@ class Paragraph extends NativeFieldWrapperClass2 { /// Builds a [Paragraph] containing text with the given styling information. /// -/// To set the paragraph's alignment, truncation, and ellipsising behavior, pass +/// To set the paragraph's alignment, truncation, and ellipsizing behavior, pass /// an appropriately-configured [ParagraphStyle] object to the [new /// ParagraphBuilder] constructor. ///