8214563: Use {@systemProperty} in specification of system properties in java.nio packages
authordkejriwal
Thu, 23 May 2019 12:36:54 +0530 (2019-05-23)
changeset 55026 a8673ccddffd
parent 55025 e93621d4db2c
child 55027 adb2493b120e
8214563: Use {@systemProperty} in specification of system properties in java.nio packages 8214565: Use {@systemProperty} for definitions of system properties Reviewed-by: alanb, rriggs
src/java.base/share/classes/java/io/FilePermission.java
src/java.base/share/classes/java/io/ObjectInputFilter.java
src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java
src/java.base/share/classes/java/nio/channels/spi/AsynchronousChannelProvider.java
src/java.base/share/classes/java/nio/channels/spi/SelectorProvider.java
src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java
--- a/src/java.base/share/classes/java/io/FilePermission.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/io/FilePermission.java	Thu May 23 12:36:54 2019 +0530
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -440,8 +440,8 @@
      * <p>A pathname containing an empty string represents an empty path.
      *
      * @implNote In this implementation, the
-     * {@code jdk.io.permissionsUseCanonicalPath} system property dictates how
-     * the {@code path} argument is processed and stored.
+     * {@systemProperty jdk.io.permissionsUseCanonicalPath} system property
+     * dictates how the {@code path} argument is processed and stored.
      * <P>
      * If the value of the system property is set to {@code true}, {@code path}
      * is canonicalized and stored as a String object named {@code cpath}.
--- a/src/java.base/share/classes/java/io/ObjectInputFilter.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/io/ObjectInputFilter.java	Thu May 23 12:36:54 2019 +0530
@@ -205,7 +205,7 @@
      * <p>
      * The filter is configured during the initialization of the {@code ObjectInputFilter.Config}
      * class. For example, by calling {@link #getSerialFilter() Config.getSerialFilter}.
-     * If the system property {@code jdk.serialFilter} is defined, it is used
+     * If the system property {@systemProperty jdk.serialFilter} is defined, it is used
      * to configure the filter.
      * If the system property is not defined, and the {@link java.security.Security}
      * property {@code jdk.serialFilter} is defined then it is used to configure the filter.
--- a/src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java	Thu May 23 12:36:54 2019 +0530
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -70,7 +70,9 @@
  *   </thead>
  *   <tbody>
  *   <tr>
- *     <th scope="row"> {@code java.nio.channels.DefaultThreadPool.threadFactory} </th>
+ *     <th scope="row">
+ *       {@systemProperty java.nio.channels.DefaultThreadPool.threadFactory}
+ *     </th>
  *     <td> The value of this property is taken to be the fully-qualified name
  *     of a concrete {@link java.util.concurrent.ThreadFactory ThreadFactory}
  *     class. The class is loaded using the system class loader and instantiated.
@@ -81,7 +83,9 @@
  *     construction of the default group. </td>
  *   </tr>
  *   <tr>
- *     <th scope="row"> {@code java.nio.channels.DefaultThreadPool.initialSize} </th>
+ *     <th scope="row">
+ *       {@systemProperty java.nio.channels.DefaultThreadPool.initialSize}
+ *     </th>
  *     <td> The value of the {@code initialSize} parameter for the default
  *     group (see {@link #withCachedThreadPool withCachedThreadPool}).
  *     The value of the property is taken to be the {@code String}
--- a/src/java.base/share/classes/java/nio/channels/spi/AsynchronousChannelProvider.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/nio/channels/spi/AsynchronousChannelProvider.java	Thu May 23 12:36:54 2019 +0530
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -138,10 +138,10 @@
      * <ol>
      *
      *   <li><p> If the system property
-     *   {@code java.nio.channels.spi.AsynchronousChannelProvider} is defined
-     *   then it is taken to be the fully-qualified name of a concrete provider class.
-     *   The class is loaded and instantiated; if this process fails then an
-     *   unspecified error is thrown.  </p></li>
+     *   {@systemProperty java.nio.channels.spi.AsynchronousChannelProvider} is
+     *   defined then it is taken to be the fully-qualified name of a concrete
+     *   provider class. The class is loaded and instantiated; if this process
+     *   fails then an unspecified error is thrown.  </p></li>
      *
      *   <li><p> If a provider class has been installed in a jar file that is
      *   visible to the system class loader, and that jar file contains a
--- a/src/java.base/share/classes/java/nio/channels/spi/SelectorProvider.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/nio/channels/spi/SelectorProvider.java	Thu May 23 12:36:54 2019 +0530
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -143,10 +143,10 @@
      * <ol>
      *
      *   <li><p> If the system property
-     *   {@code java.nio.channels.spi.SelectorProvider} is defined then it is
-     *   taken to be the fully-qualified name of a concrete provider class.
-     *   The class is loaded and instantiated; if this process fails then an
-     *   unspecified error is thrown.  </p></li>
+     *   {@systemProperty java.nio.channels.spi.SelectorProvider} is defined
+     *   then it is taken to be the fully-qualified name of a concrete provider
+     *   class. The class is loaded and instantiated; if this process fails then
+     *   an unspecified error is thrown.  </p></li>
      *
      *   <li><p> If a provider class has been installed in a jar file that is
      *   visible to the system class loader, and that jar file contains a
--- a/src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java	Fri May 24 09:51:02 2019 +0200
+++ b/src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java	Thu May 23 12:36:54 2019 +0530
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2007, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -85,7 +85,7 @@
  * provides access to the file systems accessible to the Java virtual machine.
  * The {@link FileSystems} class defines how file system providers are located
  * and loaded. The default provider is typically a system-default provider but
- * may be overridden if the system property {@code
+ * may be overridden if the system property {@systemProperty
  * java.nio.file.spi.DefaultFileSystemProvider} is set. In that case, the
  * provider has a one argument constructor whose formal parameter type is {@code
  * FileSystemProvider}. All other providers have a zero argument constructor