Use consistent style for deprecation messages

Author: sbrannen

junit-platform-commons/src/main/java/org/junit/platform/commons/util/ReflectionUtils.java

@@ -885,6 +885,8 @@ else if (methodPart.endsWith(")")) {
 	 * @param requiredType the required type of the outermost instance; never {@code null}
 	 * @return an {@code Optional} containing the outermost instance; never {@code null}
 	 * but potentially empty
+	 * @deprecated Please discontinue use of this method since it relies on internal
+	 * implementation details of the JDK that may not work in the future.
 	 */
 	@API(status = DEPRECATED, since = "1.4")
 	@Deprecated

junit-platform-engine/src/main/java/org/junit/platform/engine/support/filter/ClasspathScanningSupport.java

@@ -28,7 +28,7 @@
  * Support utility methods for classpath scanning.
  *
  * @since 1.0
- * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver}
+ * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver} instead.
  */
 @Deprecated
 @API(status = DEPRECATED, since = "1.5")
@@ -43,7 +43,7 @@ private ClasspathScanningSupport() {
 	 * classpath scanning from an {@link EngineDiscoveryRequest}.
 	 *
 	 * @param request the request to build a predicate from
-	 * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver}
+	 * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver} instead.
 	 */
 	@Deprecated
 	public static Predicate<String> buildClassNamePredicate(EngineDiscoveryRequest request) {
@@ -60,7 +60,7 @@ public static Predicate<String> buildClassNamePredicate(EngineDiscoveryRequest r
 	 *
 	 * @param request the request to build a name predicate from
 	 * @param classPredicate the class predicate
-	 * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver}
+	 * @deprecated Please use {@link org.junit.platform.engine.support.discovery.EngineDiscoveryRequestResolver} instead.
 	 */
 	@Deprecated
 	public static ClassFilter buildClassFilter(EngineDiscoveryRequest request, Predicate<Class<?>> classPredicate) {

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

@@ -94,7 +94,8 @@ protected TestPlan(boolean containsTests) {
 	 * Add the supplied {@link TestIdentifier} to this test plan.
 	 *
 	 * @param testIdentifier the identifier to add; never {@code null}
-	 * @deprecated without replacement since this method was intended to be internal.
+	 * @deprecated Please discontinue use of this method. A future version of the
+	 * JUnit Platform will ignore this call and eventually even throw an exception.
 	 */
 	@Deprecated
 	@API(status = DEPRECATED, since = "1.4")