anchor.diff:    /// can be expanded beyond that. Anything larger than 24px will require
     /// additional padding to ensure it matches the material spec of 12px padding
     /// between the right edge of the input and trailing edge of the prefix icon.
  -  /// To pad the trailing edge of the suffix icon:
  +  /// The following snipped shows how to pad the trailing edge of the suffix
  +  /// icon:
     ///
     /// ```dart
     /// suffixIcon: Padding(
     ///   padding: const EdgeInsetsDirectional.only(end: 12.0),
  -  ///   child: myIcon, // icon is 48px widget.
  +  ///   child: myIcon, // myIcon is a 48px-wide widget.
     /// )
     /// ```
     ///
  -  /// The decoration's container is the area which is filled if [isFilled] is
  +  /// The decoration's container is the area which is filled if [filled] is
     /// true and bordered per the [border]. It's the area adjacent to
     /// [decoration.icon] and above the widgets that contain [helperText],
     /// [errorText], and [counterText].
     ///
  -  /// See [Icon], [ImageIcon].
  +  /// See also:
  +  ///
  +  ///  * [Icon] and [ImageIcon], which are typically used to show icons.
  +  ///  * [suffix] and [suffixText], which are other ways to show content
  +  ///    after the text field (but before the icon).
  +  ///  * [prefixIcon], which is the same but on the leading edge.
     final Widget suffixIcon;
   
     /// Optional widget to place on the line after the input.
  -  /// Can be used to add some padding to the [suffixText] or to
  -  /// add a custom widget after the input. The widget's baseline
  -  /// is lined up with the input baseline.
  +  ///
  +  /// This can be used, for example, to add some padding to the text that would
  +  /// otherwise be specified using [suffixText], or to add a custom widget after
  +  /// the input. The widget's baseline is lined up with the input baseline.
     ///
     /// Only one of [suffix] and [suffixText] can be specified.
  +  ///
  +  /// The [suffix] appears before the [suffixIcon], if both are specified.
  +  ///
  +  /// See also:
  +  ///
  +  ///  * [prefix], the equivalent but on the leading edge.
     final Widget suffix;
   
     /// Optional text suffix to place on the line after the input.
     ///
  -  /// Uses the [suffixStyle]. Uses [hintStyle] if [suffixStyle] isn't
  -  /// specified. Suffix is not returned as part of the input.
  +  /// Uses the [suffixStyle]. Uses [hintStyle] if [suffixStyle] isn't specified.
  +  /// The suffix text is not returned as part of the user's input.
  +  ///
  +  /// If a more elaborate suffix is required, consider using [suffix] instead.
  +  /// Only one of [suffix] and [suffixText] can be specified.
  +  ///
  +  /// The [suffixText] appears before the [suffixIcon], if both are specified.
  +  ///
  +  /// See also:
  +  ///
  +  ///  * [prefixText], the equivalent but on the leading edge.
     final String suffixText;
   
     /// The style to use for the [suffixText].
     ///
     /// If null, defaults to the [hintStyle].
  +  ///
  +  /// See also:
  +  ///
  +  ///  * [prefixStyle], the equivalent but on the leading edge.
     final TextStyle suffixStyle;
   
     /// Optional text to place below the line as a character count.
  
positive.code:   /// To create a collapsed input decoration, use [InputDecoration..collapsed].
    final bool isCollapsed;
  
    /// An icon that that appears before the [prefixText] and the input and within
    /// the decoration's container.
    ///
    /// The size and color of the prefix icon is configured automatically using an
    /// [IconTheme] and therefore does not need to be explicitly given in the
  
negative.code:   /// The padding for the input decoration's container.
    ///
    /// The decoration's container is the area which is filled if
    /// [InputDecoration.filled] is true and bordered per the [border].
    /// It's the area adjacent to [InputDecoration.icon] and above the
    /// [InputDecoration.icon] and above the widgets that contain
    /// [InputDecoration.helperText], [InputDecoration.errorText], and
  