8215156: Deprecate the -Xfuture option

Reviewed-by: dholmes

src/hotspot/share/Xusage.txt

@@ -13,6 +13,7 @@
     -Xmx<size>        set maximum Java heap size
     -Xss<size>        set java thread stack size
     -Xfuture          enable strictest checks, anticipating future default
+                      (deprecated)
     -Xrs              reduce use of OS signals by Java/VM (see documentation)
     -Xcheck:jni       perform additional checks for JNI functions
     -Xshare:off	      do not attempt to use shared class data

src/java.base/share/classes/sun/launcher/resources/launcher.properties

@@ -132,6 +132,8 @@ java.launcher.X.usage=\n\
 \    -Xdebug           provided for backward compatibility\n\
 \    -Xdiag            show additional diagnostic messages\n\
 \    -Xfuture          enable strictest checks, anticipating future default\n\
+\                      This option is deprecated and may be removed in a\n\
+\                      future release.\n\
 \    -Xint             interpreted mode execution only\n\
 \    -Xinternalversion\n\
 \                      displays more detailed JVM version information than the\n\

src/java.base/share/man/java.1

@@ -716,6 +716,8 @@ Shows additional diagnostic messages\&.
 \-Xfuture
 .RS 4
 Enables strict class\-file format checks that enforce close conformance to the class\-file format specification\&. Developers are encouraged to use this flag when developing new code because the stricter checks will become the default in future releases\&.
+.sp
+This option is deprecated and may be removed in a future release.
 .RE
 .PP
 \-Xint

src/java.base/share/native/libjli/emessages.h

@@ -38,6 +38,7 @@
 
 #define ARG_INFO_ENVVAR "NOTE: Picked up %s: %s"
 #define ARG_WARN        "Warning: %s option is no longer supported."
+#define ARG_DEPRECATED  "Warning: %s option is deprecated and may be removed in a future release."
 
 #define ARG_ERROR1      "Error: %s requires class path specification"
 #define ARG_ERROR2      "Error: %s requires jar file specification"

src/java.base/share/native/libjli/java.c

@@ -1430,6 +1430,7 @@ ParseArguments(int *pargc, char ***pargv,
         } else if (JLI_StrCmp(arg, "-noclassgc") == 0) {
             AddOption("-Xnoclassgc", NULL);
         } else if (JLI_StrCmp(arg, "-Xfuture") == 0) {
+            JLI_ReportErrorMessage(ARG_DEPRECATED, "-Xfuture");
             AddOption("-Xverify:all", NULL);
         } else if (JLI_StrCmp(arg, "-verify") == 0) {
             AddOption("-Xverify:all", NULL);