#2559. Update assertion text for for some of augmented expressions te…

…sts (#3010)

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t01.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to tear-off `augmented`
 /// expression inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t01_lib1.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to tear-off `augmented`
 /// expression inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t01_lib2.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to tear-off `augmented`
 /// expression inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t02.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t02_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t03.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// function named `augmented()` inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t03_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// function named `augmented()` inside of an augmenting function

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t04.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t04_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t05.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t05_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t06.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a list

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t06_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a list

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t07.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a map

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t07_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a map

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t08.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a record

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t08_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test a record

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t09.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test an object

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t09_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error to declare a local
 /// variable named `augmented` inside of an augmenting function. Test an object

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t10.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare a positional parameter named `augmented`.

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t10_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare a positional parameter named `augmented`.

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t11.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare a named parameter with the name `augmented`.

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t11_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare a named parameter with the name `augmented`.

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t12.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare an optional positional parameter with the name

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t12_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to declare an optional positional parameter with the name

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t13.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to have as a positional parameter a record with a positional field

LanguageFeatures/Augmentation-libraries/augmented_expression_A04_t13_lib.dart

@@ -6,9 +6,10 @@
 /// being augmented, but it generally follows the same rules as any normal
 /// identifier:
 /// ...
-/// - Augmenting functions: When augmenting a function, `augmented` refers to
-///   the augmented function. Tear offs are not allowed, so this function must
-///   immediately be invoked.
+/// - Augmenting functions: Inside an augmenting function body (including
+///   factory constructors but not generative constructors) `augmented` refers
+///   to the augmented function. Tear-offs are not allowed, and this function
+///   must immediately be invoked.
 ///
 /// @description Checks that it is a compile-time error for an augmenting
 /// function to have as a positional parameter a record with a positional field