#2559. Update assertions for some Augmenting libraries tests

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A06_t01.dart

@@ -4,8 +4,9 @@
 
 /// @assertion It is a compile-time error if:
 /// ...
-/// - The resulting constructor is not valid (has a redirecting initializer and
-///   other initializers, multiple super initializers, etc).
+/// - The resulting constructor is not valid (it has a redirection as well as
+///   some initializer list elements, or it has multiple `super` initializers,
+///   etc).
 ///
 /// @description Checks that it is a compile-time error if the resulting
 /// constructor has a redirecting initializer and other initializers.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A06_t01_lib.dart

@@ -4,8 +4,9 @@
 
 /// @assertion It is a compile-time error if:
 /// ...
-/// - The resulting constructor is not valid (has a redirecting initializer and
-///   other initializers, multiple super initializers, etc).
+/// - The resulting constructor is not valid (it has a redirection as well as
+///   some initializer list elements, or it has multiple `super` initializers,
+///   etc).
 ///
 /// @description Checks that it is a compile-time error if the resulting
 /// constructor has a redirecting initializer and other initializers.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t01.dart

@@ -3,9 +3,9 @@
 // BSD-style license that can be found in the LICENSE file.
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
-/// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
+/// ...
+/// - If the augmenting constructor has an explicit block body, then that body
+///   replaces any existing constructor body.
 ///
 /// @description Checks that if the augmenting constructor has an explicit block
 /// body, then that body replaces any existing constructor body.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t01_lib.dart

@@ -3,9 +3,9 @@
 // BSD-style license that can be found in the LICENSE file.
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
-/// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
+/// ...
+/// - If the augmenting constructor has an explicit block body, then that body
+///   replaces any existing constructor body.
 ///
 /// @description Checks that if the augmenting constructor has an explicit block
 /// body, then that body replaces any existing constructor body.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t02.dart

@@ -4,8 +4,6 @@
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
 /// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
 ///
 /// @description Checks that an augmenting constructor may add a body to an
 /// augmented constructor.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t02_lib.dart

@@ -4,8 +4,6 @@
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
 /// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
 ///
 /// @description Checks that an augmenting constructor may add a body to an
 /// augmented constructor.

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t03.dart

@@ -4,8 +4,6 @@
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
 /// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
 ///
 /// @description Checks that it is a compile-time error to augment a default
 /// unnamed constructor (that doesn't exist during augmentation).

LanguageFeatures/Augmentation-libraries/augmenting_constructors_A09_t03_lib.dart

@@ -4,8 +4,6 @@
 
 /// @assertion A non-redirecting generative constructor marked `augment` may:
 /// - Add or replace the body of the augmented constructor with a new body.
-///   - If the augmenting constructor has an explicit block body, then that body
-///     replaces any existing constructor body.
 ///
 /// @description Checks that it is a compile-time error to augment a default
 /// unnamed constructor (that doesn't exist during augmentation).

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t01.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a top-level function
 /// `augmented()` expression executes the original function body.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t01_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a top-level function
 /// `augmented()` expression executes the original function body.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t02.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test a class.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t02_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test a class.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t03.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test a mixin.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t03_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test a mixin.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t04.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an enum.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t04_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an enum.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t05.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t05_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t06.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t06_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of a static method
 /// `augmented()` expression executes the original method body. Test an

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t07.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test a class.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t07_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test a class.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t08.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test a mixin.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t08_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test a mixin.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t09.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test an enum.

LanguageFeatures/Augmentation-libraries/augmenting_functions_A02_t09_lib.dart

@@ -2,10 +2,10 @@
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
-/// @assertion Inside the augmentation body, a special `augmented()` expression
-/// may be used to execute the original function body. That expression takes an
-/// argument list matching the original function's parameter list and returns
-/// the function's return type.
+/// @assertion Inside the augmenting function’s body, a special `augmented(…)`
+/// expression may be used to execute the augmented function body. That
+/// expression takes an argument list matching the augmented function's
+/// parameter list, and it has the same return type as the enclosing function.
 ///
 /// @description Checks that inside an augmentation body of an instance method
 /// `augmented()` expression executes the original method body. Test an enum.