Unverified Commit 2919572f authored by Ian Hickson's avatar Ian Hickson Committed by GitHub

Minor documentation fixes (#126609)

Fixes for grammar, tone, and clarity.
parent 6b6c4bdb
...@@ -304,7 +304,7 @@ class BoxConstraints extends Constraints { ...@@ -304,7 +304,7 @@ class BoxConstraints extends Constraints {
/// * The size must satisfy these constraints. /// * The size must satisfy these constraints.
/// * The aspect ratio of the returned size matches the aspect ratio of the /// * The aspect ratio of the returned size matches the aspect ratio of the
/// given size. /// given size.
/// * The returned size as big as possible while still being equal to or /// * The returned size is as big as possible while still being equal to or
/// smaller than the given size. /// smaller than the given size.
Size constrainSizeAndAttemptToPreserveAspectRatio(Size size) { Size constrainSizeAndAttemptToPreserveAspectRatio(Size size) {
if (isTight) { if (isTight) {
...@@ -1486,10 +1486,10 @@ abstract class RenderBox extends RenderObject { ...@@ -1486,10 +1486,10 @@ abstract class RenderBox extends RenderObject {
/// ///
/// ### Text /// ### Text
/// ///
/// Text is the canonical example of a width-in-height-out algorithm. The /// English text is the canonical example of a width-in-height-out algorithm.
/// `height` argument is therefore ignored. /// The `height` argument is therefore ignored.
/// ///
/// Consider the string "Hello World" The _maximum_ intrinsic width (as /// Consider the string "Hello World". The _maximum_ intrinsic width (as
/// returned from [computeMaxIntrinsicWidth]) would be the width of the string /// returned from [computeMaxIntrinsicWidth]) would be the width of the string
/// with no line breaks. /// with no line breaks.
/// ///
...@@ -1498,12 +1498,12 @@ abstract class RenderBox extends RenderObject { ...@@ -1498,12 +1498,12 @@ abstract class RenderBox extends RenderObject {
/// might still not overflow. For example, maybe the rendering would put a /// might still not overflow. For example, maybe the rendering would put a
/// line-break half-way through the words, as in "Hel⁞lo⁞Wor⁞ld". However, /// line-break half-way through the words, as in "Hel⁞lo⁞Wor⁞ld". However,
/// this wouldn't be a _correct_ rendering, and [computeMinIntrinsicWidth] is /// this wouldn't be a _correct_ rendering, and [computeMinIntrinsicWidth] is
/// supposed to render the minimum width that the box could be without failing /// defined as returning the minimum width that the box could be without
/// to _correctly_ paint the contents within itself. /// failing to _correctly_ paint the contents within itself.
/// ///
/// The minimum intrinsic _height_ for a given width smaller than the minimum /// The minimum intrinsic _height_ for a given width _smaller_ than the
/// intrinsic width could therefore be greater than the minimum intrinsic /// minimum intrinsic width could therefore be greater than the minimum
/// height for the minimum intrinsic width. /// intrinsic height for the minimum intrinsic width.
/// ///
/// ### Viewports (e.g. scrolling lists) /// ### Viewports (e.g. scrolling lists)
/// ///
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment