Undeprecate traditional execute() methods in the Launcher API

This commit undeprecates the execute(TestPlan, ...) and
execute(LauncherDiscoveryRequest, ...) methods in the Launcher API.

See #4724
Closes #4866

Author: sbrannen

documentation/src/docs/asciidoc/release-notes/release-notes-6.0.0-RC2.adoc

@@ -36,6 +36,9 @@ guidance on upgrading from JUnit 5.x.y to 6.0.0.
 [[release-notes-6.0.0-RC2-junit-platform-new-features-and-improvements]]
 ==== New Features and Improvements
 
+* The `execute(TestPlan,{nbsp}TestExecutionListener...)` and
+  `execute(LauncherDiscoveryRequest,{nbsp}TestExecutionListener...)` methods in the
+  `Launcher` API are no longer deprecated.
 * New `discoveryRequest()` method in `{LauncherDiscoveryRequestBuilder}`, which is an
   alias for the existing `request()` method and is intended to be used via a `static`
   import.

junit-platform-launcher/src/main/java/org/junit/platform/launcher/Launcher.java

@@ -10,7 +10,6 @@
 
 package org.junit.platform.launcher;
 
-import static org.apiguardian.api.API.Status.DEPRECATED;
 import static org.apiguardian.api.API.Status.MAINTAINED;
 import static org.apiguardian.api.API.Status.STABLE;
 
@@ -107,10 +106,9 @@ public interface Launcher {
 	 *
 	 * @param discoveryRequest the launcher discovery request; never {@code null}
 	 * @param listeners additional test execution listeners; never {@code null}
-	 * @deprecated Please use {@link #execute(LauncherExecutionRequest)} instead.
+	 * @see #execute(TestPlan, TestExecutionListener...)
+	 * @see #execute(LauncherExecutionRequest)
 	 */
-	@Deprecated(since = "6.0")
-	@API(status = DEPRECATED, since = "6.0")
 	default void execute(LauncherDiscoveryRequest discoveryRequest, TestExecutionListener... listeners) {
 		var executionRequest = LauncherExecutionRequestBuilder.request(discoveryRequest) //
 				.listeners(listeners) //
@@ -133,10 +131,10 @@ default void execute(LauncherDiscoveryRequest discoveryRequest, TestExecutionLis
 	 * @param testPlan the test plan to execute; never {@code null}
 	 * @param listeners additional test execution listeners; never {@code null}
 	 * @since 1.4
-	 * @deprecated Please use {@link #execute(LauncherExecutionRequest)} instead.
+	 * @see #execute(LauncherDiscoveryRequest, TestExecutionListener...)
+	 * @see #execute(LauncherExecutionRequest)
 	 */
-	@Deprecated(since = "6.0")
-	@API(status = DEPRECATED, since = "6.0")
+	@API(status = STABLE, since = "1.4")
 	default void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 		var executionRequest = LauncherExecutionRequestBuilder.request(testPlan) //
 				.listeners(listeners) //
@@ -168,6 +166,8 @@ default void execute(TestPlan testPlan, TestExecutionListener... listeners) {
 	 *
 	 * @param executionRequest the launcher execution request; never {@code null}
 	 * @since 6.0
+	 * @see #execute(LauncherDiscoveryRequest, TestExecutionListener...)
+	 * @see #execute(TestPlan, TestExecutionListener...)
 	 */
 	@API(status = MAINTAINED, since = "6.0")
 	void execute(LauncherExecutionRequest executionRequest);

platform-tests/src/test/java/org/junit/platform/launcher/core/LauncherSessionTests.java

@@ -36,7 +36,6 @@ class LauncherSessionTests {
 			.build();
 	LauncherDiscoveryRequest discoveryRequest = discoveryRequest().build();
 
-	@SuppressWarnings("deprecation")
 	@Test
 	void callsRegisteredListenersWhenLauncherIsUsedDirectly() {
 		var launcher = LauncherFactory.create(launcherConfig);
@@ -87,7 +86,7 @@ void callsRegisteredListenersWhenLauncherIsUsedDirectly() {
 	}
 
 	@Test
-	@SuppressWarnings({ "deprecation", "resource" })
+	@SuppressWarnings("resource")
 	void callsRegisteredListenersWhenLauncherIsUsedViaSession() {
 		var session = LauncherFactory.openSession(launcherConfig);
 		var launcher = session.getLauncher();
@@ -115,7 +114,7 @@ void callsRegisteredListenersWhenLauncherIsUsedViaSession() {
 	}
 
 	@Test
-	@SuppressWarnings({ "deprecation", "resource" })
+	@SuppressWarnings("resource")
 	void closedSessionCannotBeUsed() {
 		var session = LauncherFactory.openSession(launcherConfig);
 		var launcher = session.getLauncher();