Add extra documentation to Enum to point to EnumName.

Closes #53164

GitOrigin-RevId: 0c96101
Change-Id: I26391dddde87cdea0cc6ae4a70d04be1a48576f2
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/319463
Reviewed-by: Johnni Winther <[email protected]>
Reviewed-by: Lasse Nielsen <[email protected]>
Reviewed-by: Nate Bosch <[email protected]>
Commit-Queue: Lasse Nielsen <[email protected]>

Author: lrhn

pkg/front_end/testcases/enhanced_enums/declared_index.dart.strong.expect

@@ -33,58 +33,58 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:26:16: Error: Can't declare a member that conflicts with an inherited one.
 //   List<String> index() => []; // Error.
 //                ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:64:18: Error: Can't declare a member that conflicts with an inherited one.
 //   static int get index => 42; // Error.
 //                  ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:70:19: Error: Can't declare a member that conflicts with an inherited one.
 //   static void set index(int value) {} // Error.
 //                   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:74:3: Error: Can't declare a member that conflicts with an inherited one.
 //   index // Error.
 //   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:14:14: Error: The return type of the method 'E2.index' is 'String', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   String get index => "foo"; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:52:12: Error: The type 'int' of the inherited field '_Enum.index' is not a subtype of the type 'String' of the setter 'E8.index'.
 //   void set index(String value) {} // Error.
 //            ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the declaration of the field '_Enum.index'.
+// sdk/lib/core/enum.dart:104:13: Context: This is the declaration of the field '_Enum.index'.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:58:14: Error: The return type of the method 'E9.index' is 'double', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   double get index; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:55:6: Error: The implementation of 'index' in the non-abstract class 'E9' does not conform to its interface.
 // enum E9 {
 //      ^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
 // Change to a subtype of 'double'.
 //   final int index;
 //             ^
@@ -95,7 +95,7 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:87:6: Error: The implementation of 'index' in the non-abstract class 'E14' does not conform to its interface.
 // enum E14 implements I14 { element } // Error.
 //      ^^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
 // Change to a subtype of 'Never'.
 //   final int index;
 //             ^

pkg/front_end/testcases/enhanced_enums/declared_index.dart.weak.expect

@@ -33,58 +33,58 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:26:16: Error: Can't declare a member that conflicts with an inherited one.
 //   List<String> index() => []; // Error.
 //                ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:64:18: Error: Can't declare a member that conflicts with an inherited one.
 //   static int get index => 42; // Error.
 //                  ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:70:19: Error: Can't declare a member that conflicts with an inherited one.
 //   static void set index(int value) {} // Error.
 //                   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:74:3: Error: Can't declare a member that conflicts with an inherited one.
 //   index // Error.
 //   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:14:14: Error: The return type of the method 'E2.index' is 'String', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   String get index => "foo"; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:52:12: Error: The type 'int' of the inherited field '_Enum.index' is not a subtype of the type 'String' of the setter 'E8.index'.
 //   void set index(String value) {} // Error.
 //            ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the declaration of the field '_Enum.index'.
+// sdk/lib/core/enum.dart:104:13: Context: This is the declaration of the field '_Enum.index'.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:58:14: Error: The return type of the method 'E9.index' is 'double', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   double get index; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:55:6: Error: The implementation of 'index' in the non-abstract class 'E9' does not conform to its interface.
 // enum E9 {
 //      ^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
 // Change to a subtype of 'double'.
 //   final int index;
 //             ^
@@ -95,7 +95,7 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:87:6: Error: The implementation of 'index' in the non-abstract class 'E14' does not conform to its interface.
 // enum E14 implements I14 { element } // Error.
 //      ^^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
 // Change to a subtype of 'Never'.
 //   final int index;
 //             ^

pkg/front_end/testcases/enhanced_enums/declared_index.dart.weak.modular.expect

@@ -33,58 +33,58 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:26:16: Error: Can't declare a member that conflicts with an inherited one.
 //   List<String> index() => []; // Error.
 //                ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:64:18: Error: Can't declare a member that conflicts with an inherited one.
 //   static int get index => 42; // Error.
 //                  ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:70:19: Error: Can't declare a member that conflicts with an inherited one.
 //   static void set index(int value) {} // Error.
 //                   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:74:3: Error: Can't declare a member that conflicts with an inherited one.
 //   index // Error.
 //   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:14:14: Error: The return type of the method 'E2.index' is 'String', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   String get index => "foo"; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:52:12: Error: The type 'int' of the inherited field '_Enum.index' is not a subtype of the type 'String' of the setter 'E8.index'.
 //   void set index(String value) {} // Error.
 //            ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the declaration of the field '_Enum.index'.
+// sdk/lib/core/enum.dart:104:13: Context: This is the declaration of the field '_Enum.index'.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:58:14: Error: The return type of the method 'E9.index' is 'double', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   double get index; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:55:6: Error: The implementation of 'index' in the non-abstract class 'E9' does not conform to its interface.
 // enum E9 {
 //      ^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
 // Change to a subtype of 'double'.
 //   final int index;
 //             ^
@@ -95,7 +95,7 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:87:6: Error: The implementation of 'index' in the non-abstract class 'E14' does not conform to its interface.
 // enum E14 implements I14 { element } // Error.
 //      ^^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
 // Change to a subtype of 'Never'.
 //   final int index;
 //             ^

pkg/front_end/testcases/enhanced_enums/declared_index.dart.weak.outline.expect

@@ -33,58 +33,58 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:26:16: Error: Can't declare a member that conflicts with an inherited one.
 //   List<String> index() => []; // Error.
 //                ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:64:18: Error: Can't declare a member that conflicts with an inherited one.
 //   static int get index => 42; // Error.
 //                  ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:70:19: Error: Can't declare a member that conflicts with an inherited one.
 //   static void set index(int value) {} // Error.
 //                   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:74:3: Error: Can't declare a member that conflicts with an inherited one.
 //   index // Error.
 //   ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the inherited member.
+// sdk/lib/core/enum.dart:104:13: Context: This is the inherited member.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:14:14: Error: The return type of the method 'E2.index' is 'String', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   String get index => "foo"; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:52:12: Error: The type 'int' of the inherited field '_Enum.index' is not a subtype of the type 'String' of the setter 'E8.index'.
 //   void set index(String value) {} // Error.
 //            ^^^^^
-// sdk/lib/core/enum.dart:101:13: Context: This is the declaration of the field '_Enum.index'.
+// sdk/lib/core/enum.dart:104:13: Context: This is the declaration of the field '_Enum.index'.
 //   final int index;
 //             ^^^^^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:58:14: Error: The return type of the method 'E9.index' is 'double', which does not match the return type, 'int', of the overridden method, '_Enum.index'.
 // Change to a subtype of 'int'.
 //   double get index; // Error.
 //              ^
-// sdk/lib/core/enum.dart:101:13: Context: This is the overridden method ('index').
+// sdk/lib/core/enum.dart:104:13: Context: This is the overridden method ('index').
 //   final int index;
 //             ^
 //
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:55:6: Error: The implementation of 'index' in the non-abstract class 'E9' does not conform to its interface.
 // enum E9 {
 //      ^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'double', of the overridden method, 'E9.index'.
 // Change to a subtype of 'double'.
 //   final int index;
 //             ^
@@ -95,7 +95,7 @@ library;
 // pkg/front_end/testcases/enhanced_enums/declared_index.dart:87:6: Error: The implementation of 'index' in the non-abstract class 'E14' does not conform to its interface.
 // enum E14 implements I14 { element } // Error.
 //      ^^^
-// sdk/lib/core/enum.dart:101:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
+// sdk/lib/core/enum.dart:104:13: Context: The return type of the method '_Enum.index' is 'int', which does not match the return type, 'Never', of the overridden method, 'I14.index'.
 // Change to a subtype of 'Never'.
 //   final int index;
 //             ^

pkg/front_end/testcases/enhanced_enums/enum_as_supertype_error.dart.strong.expect

@@ -40,7 +40,7 @@ library;
 //
 // class A extends Enum { // Error.
 //       ^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -54,7 +54,7 @@ library;
 //
 // class B implements Enum { // Error.
 //       ^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -68,7 +68,7 @@ library;
 //
 // class EnumClass2 extends AbstractEnumClass {} // Error.
 //       ^^^^^^^^^^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -82,7 +82,7 @@ library;
 //
 // class EnumClass3 extends AbstractEnumClass2 {} // Error.
 //       ^^^^^^^^^^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //

pkg/front_end/testcases/enhanced_enums/enum_as_supertype_error.dart.strong.transformed.expect

@@ -40,7 +40,7 @@ library;
 //
 // class A extends Enum { // Error.
 //       ^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -54,7 +54,7 @@ library;
 //
 // class B implements Enum { // Error.
 //       ^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -68,7 +68,7 @@ library;
 //
 // class EnumClass2 extends AbstractEnumClass {} // Error.
 //       ^^^^^^^^^^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //
@@ -82,7 +82,7 @@ library;
 //
 // class EnumClass3 extends AbstractEnumClass2 {} // Error.
 //       ^^^^^^^^^^
-// sdk/lib/core/enum.dart:22:11: Context: 'Enum.index' is defined here.
+// sdk/lib/core/enum.dart:25:11: Context: 'Enum.index' is defined here.
 //   int get index;
 //           ^^^^^
 //