Fix some doc references (#26441)

packages/flutter/lib/src/cupertino/date_picker.dart

@@ -915,15 +915,15 @@ class _CupertinoDatePickerDateState extends State<CupertinoDatePicker> {
 enum CupertinoTimerPickerMode {
   /// Mode that shows the timer duration in hour and minute.
   ///
-  /// Examples: [16 hours | 14 min].
+  /// Examples: 16 hours | 14 min.
   hm,
   /// Mode that shows the timer duration in minute and second.
   ///
-  /// Examples: [14 min | 43 sec].
+  /// Examples: 14 min | 43 sec.
   ms,
   /// Mode that shows the timer duration in hour, minute, and second.
   ///
-  /// Examples: [16 hours | 14 min | 43 sec].
+  /// Examples: 16 hours | 14 min | 43 sec.
   hms,
 }
 

packages/flutter/lib/src/cupertino/localizations.dart

@@ -7,24 +7,26 @@ import 'dart:async';
 import 'package:flutter/foundation.dart';
 import 'package:flutter/widgets.dart';
 
+import 'date_picker.dart';
+
 /// Determines the order of the columns inside [CupertinoDatePicker] in
 /// time and date time mode.
 enum DatePickerDateTimeOrder {
   /// Order of the columns, from left to right: date, hour, minute, am/pm.
   ///
-  /// Example: [Fri Aug 31 | 02 | 08 | PM].
+  /// Example: Fri Aug 31 | 02 | 08 | PM.
   date_time_dayPeriod,
   /// Order of the columns, from left to right: date, am/pm, hour, minute.
   ///
-  /// Example: [Fri Aug 31 | PM | 02 | 08].
+  /// Example: Fri Aug 31 | PM | 02 | 08.
   date_dayPeriod_time,
   /// Order of the columns, from left to right: hour, minute, am/pm, date.
   ///
-  /// Example: [02 | 08 | PM | Fri Aug 31].
+  /// Example: 02 | 08 | PM | Fri Aug 31.
   time_dayPeriod_date,
   /// Order of the columns, from left to right: am/pm, hour, minute, date.
   ///
-  /// Example: [PM | 02 | 08 | Fri Aug 31].
+  /// Example: PM | 02 | 08 | Fri Aug 31.
   dayPeriod_time_date,
 }
 
@@ -32,19 +34,19 @@ enum DatePickerDateTimeOrder {
 enum DatePickerDateOrder {
   /// Order of the columns, from left to right: day, month, year.
   ///
-  /// Example: [12 | March | 1996]
+  /// Example: 12 | March | 1996
   dmy,
   /// Order of the columns, from left to right: month, day, year.
   ///
-  /// Example: [March | 12 | 1996]
+  /// Example: March | 12 | 1996
   mdy,
   /// Order of the columns, from left to right: year, month, day.
   ///
-  /// Example: [1996 | March | 12]
+  /// Example: 1996 | March | 12
   ymd,
   /// Order of the columns, from left to right: year, day, month.
   ///
-  /// Example: [1996 | 12 | March]
+  /// Example: 1996 | 12 | March
   ydm,
 }
 
@@ -131,7 +133,7 @@ abstract class CupertinoLocalizations {
   /// The term used by the system to announce dialog alerts.
   String get alertDialogLabel;
 
-  /// Hour that is shown in [CupertinoCountdownTimerPicker] corresponding to
+  /// Hour that is shown in [CupertinoTimerPicker] corresponding to
   /// the given hour value.
   ///
   /// Examples: timerPickerHour(1) in:
@@ -140,7 +142,7 @@ abstract class CupertinoLocalizations {
   ///  - Arabic: ١
   String timerPickerHour(int hour);
 
-  /// Minute that is shown in [CupertinoCountdownTimerPicker] corresponding to
+  /// Minute that is shown in [CupertinoTimerPicker] corresponding to
   /// the given minute value.
   ///
   /// Examples: timerPickerMinute(1) in:
@@ -149,7 +151,7 @@ abstract class CupertinoLocalizations {
   ///  - Arabic: ١
   String timerPickerMinute(int minute);
 
-  /// Second that is shown in [CupertinoCountdownTimerPicker] corresponding to
+  /// Second that is shown in [CupertinoTimerPicker] corresponding to
   /// the given second value.
   ///
   /// Examples: timerPickerSecond(1) in:
@@ -159,17 +161,17 @@ abstract class CupertinoLocalizations {
   String timerPickerSecond(int second);
 
   /// Label that appears next to the hour picker in
-  /// [CupertinoCountdownTimerPicker] when selected hour value is `hour`.
+  /// [CupertinoTimerPicker] when selected hour value is `hour`.
   /// This function will deal with pluralization based on the `hour` parameter.
   String timerPickerHourLabel(int hour);
 
   /// Label that appears next to the minute picker in
-  /// [CupertinoCountdownTimerPicker] when selected minute value is `minute`.
+  /// [CupertinoTimerPicker] when selected minute value is `minute`.
   /// This function will deal with pluralization based on the `minute` parameter.
   String timerPickerMinuteLabel(int minute);
 
   /// Label that appears next to the minute picker in
-  /// [CupertinoCountdownTimerPicker] when selected minute value is `second`.
+  /// [CupertinoTimerPicker] when selected minute value is `second`.
   /// This function will deal with pluralization based on the `second` parameter.
   String timerPickerSecondLabel(int second);
 

packages/flutter/lib/src/cupertino/tab_scaffold.dart

@@ -89,10 +89,7 @@ import 'theme.dart';
 class CupertinoTabScaffold extends StatefulWidget {
   /// Creates a layout for applications with a tab bar at the bottom.
   ///
-  /// The [tabBar], [tabBuilder] and [currentTabIndex] arguments must not be null.
-  ///
-  /// The [currentTabIndex] argument can be used to programmatically change the
-  /// currently selected tab.
+  /// The [tabBar] and [tabBuilder] arguments must not be null.
   const CupertinoTabScaffold({
     Key key,
     @required this.tabBar,

packages/flutter/lib/src/cupertino/text_field.dart

@@ -294,10 +294,6 @@ class CupertinoTextField extends StatefulWidget {
   /// Whitespace characters (e.g. newline, space, tab) are included in the
   /// character count.
   ///
-  /// If [maxLengthEnforced] is set to false, then more than [maxLength]
-  /// characters may be entered, but the error counter and divider will
-  /// switch to the [decoration.errorStyle] when the limit is exceeded.
-  ///
   /// ## Limitations
   ///
   /// The CupertinoTextField does not currently count Unicode grapheme clusters

packages/flutter/lib/src/foundation/diagnostics.dart

@@ -703,7 +703,7 @@ abstract class DiagnosticsNode {
   /// than `minLevel`.
   ///
   /// If `minLevel` is [DiagnosticLevel.hidden] no diagnostics will be filtered.
-  /// If `minLevel` is [DiagnosticsLevel.off] all diagnostics will be filtered.
+  /// If `minLevel` is [DiagnosticLevel.off] all diagnostics will be filtered.
   bool isFiltered(DiagnosticLevel minLevel) => level.index < minLevel.index;
 
   /// Priority level of the diagnostic used to control which diagnostics should
@@ -854,8 +854,7 @@ abstract class DiagnosticsNode {
   ///
   /// See also:
   ///
-  ///  * [toString], for a brief description of the [value] but not its children.
-  ///  * [toStringShallow], for a detailed description of the [value] but not its
+  ///  * [toString], for a brief description of the [value] but not its
   ///    children.
   String toStringDeep({
     String prefixLineOne = '',
@@ -1558,7 +1557,7 @@ class EnumProperty<T> extends DiagnosticsProperty<T> {
 /// The [ifPresent] and [ifNull] strings describe the property [value] when it
 /// is non-null and null respectively. If one of [ifPresent] or [ifNull] is
 /// omitted, that is taken to mean that [level] should be
-/// [DiagnosticsLevel.hidden] when [value] is non-null or null respectively.
+/// [DiagnosticLevel.hidden] when [value] is non-null or null respectively.
 ///
 /// This kind of diagnostics property is typically used for values mostly opaque
 /// values, like closures, where presenting the actual object is of dubious
@@ -1615,7 +1614,7 @@ class ObjectFlagProperty<T> extends DiagnosticsProperty<T> {
   /// Description to use if the property [value] is not null.
   ///
   /// If the property [value] is not null and [ifPresent] is null, the
-  /// [level] for the property is [DiagnosticsLevel.hidden] and the description
+  /// [level] for the property is [DiagnosticLevel.hidden] and the description
   /// from superclass is used.
   final String ifPresent;
 
@@ -2102,17 +2101,17 @@ class DiagnosticPropertiesBuilder {
 ///  * [DiagnosticableTree], which extends this class to also describe the
 ///    children of a tree structured object.
 ///  * [Diagnosticable.debugFillProperties], which lists best practices
-///    for specifying the properties of a [DiagnosticNode]. The most common use
+///    for specifying the properties of a [DiagnosticsNode]. The most common use
 ///    case is to override [debugFillProperties] defining custom properties for
-///    a subclass of [TreeDiagnosticsMixin] using the existing
+///    a subclass of [DiagnosticableTreeMixin] using the existing
 ///    [DiagnosticsProperty] subclasses.
 ///  * [DiagnosticableTree.debugDescribeChildren], which lists best practices
-///    for describing the children of a [DiagnosticNode]. Typically the base
+///    for describing the children of a [DiagnosticsNode]. Typically the base
 ///    class already describes the children of a node properly or a node has
 ///    no children.
 ///  * [DiagnosticsProperty], which should be used to create leaf diagnostic
-///    nodes without properties or children. There are many [DiagnosticProperty]
-///    subclasses to handle common use cases.
+///    nodes without properties or children. There are many
+///    [DiagnosticsProperty] subclasses to handle common use cases.
 abstract class Diagnosticable {
   /// Abstract const constructor. This constructor enables subclasses to provide
   /// const constructors so that they can be used in const expressions.
@@ -2132,7 +2131,7 @@ abstract class Diagnosticable {
   }
 
   /// Returns a debug representation of the object that is used by debugging
-  /// tools and by [toStringDeep].
+  /// tools and by [DiagnosticsNode.toStringDeep].
   ///
   /// Leave [name] as null if there is not a meaningful description of the
   /// relationship between the this node and its parent.

packages/flutter/lib/src/material/material_localizations.dart

@@ -7,6 +7,7 @@ import 'dart:async';
 import 'package:flutter/foundation.dart';
 import 'package:flutter/widgets.dart';
 
+import 'reorderable_list.dart';
 import 'text_theme.dart';
 import 'time.dart';
 import 'typography.dart';
@@ -277,27 +278,27 @@ abstract class MaterialLocalizations {
   /// shows the list of accounts.
   String get showAccountsLabel;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list to the start of the list.
   String get reorderItemToStart;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list to the end of the list.
   String get reorderItemToEnd;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list one space up the list.
   String get reorderItemUp;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list one space down the list.
   String get reorderItemDown;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list one space left in the list.
   String get reorderItemLeft;
 
-  /// The semantics label used for [ReorderableList] to reorder an item in the
+  /// The semantics label used for [ReorderableListView] to reorder an item in the
   /// list one space right in the list.
   String get reorderItemRight;
 

packages/flutter/lib/src/semantics/semantics.dart

@@ -2621,8 +2621,8 @@ class SemanticsConfiguration {
   /// is set on the same node, all previously painted siblings and cousins up
   /// until the next ancestor that is a semantic boundary are dropped.
   ///
-  /// Paint order as established by [visitChildrenForSemantics] is used to
-  /// determine if a node is previous to this one.
+  /// Paint order as established by [RenderObject.visitChildrenForSemantics] is
+  /// used to determine if a node is previous to this one.
   bool isBlockingSemanticsOfPreviouslyPaintedNodes = false;
 
   // SEMANTIC ANNOTATIONS