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

@@ -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 @@ public final class FilePermission extends Permission implements Serializable {
      * <p>A pathname containing an empty string represents an empty path.
      *
      * @implNote In this implementation, the
-     * {@code jdk.io.permissionsUseCanonicalPath} system property dictates how
+     * {@systemProperty jdk.io.permissionsUseCanonicalPath} system property
-     * the {@code path} argument is processed and stored.
+     * 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}.

src/java.base/share/classes/java/io/ObjectInputFilter.java

@@ -205,7 +205,7 @@ public interface ObjectInputFilter {
      * <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.

src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java

@@ -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 @@ import java.util.concurrent.TimeUnit;
  *   </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 @@ import java.util.concurrent.TimeUnit;
  *     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}

src/java.base/share/classes/java/nio/channels/spi/AsynchronousChannelProvider.java

@@ -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 @@ public abstract class AsynchronousChannelProvider {
      * <ol>
      *
      *   <li><p> If the system property
-     *   {@code java.nio.channels.spi.AsynchronousChannelProvider} is defined
+     *   {@systemProperty java.nio.channels.spi.AsynchronousChannelProvider} is
-     *   then it is taken to be the fully-qualified name of a concrete provider class.
+     *   defined then it is taken to be the fully-qualified name of a concrete
-     *   The class is loaded and instantiated; if this process fails then an
+     *   provider class. The class is loaded and instantiated; if this process
-     *   unspecified error is thrown.  </p></li>
+     *   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

src/java.base/share/classes/java/nio/channels/spi/SelectorProvider.java

@@ -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 @@ public abstract class SelectorProvider {
      * <ol>
      *
      *   <li><p> If the system property
-     *   {@code java.nio.channels.spi.SelectorProvider} is defined then it is
+     *   {@systemProperty java.nio.channels.spi.SelectorProvider} is defined
-     *   taken to be the fully-qualified name of a concrete provider class.
+     *   then it is taken to be the fully-qualified name of a concrete provider
-     *   The class is loaded and instantiated; if this process fails then an
+     *   class. The class is loaded and instantiated; if this process fails then
-     *   unspecified error is thrown.  </p></li>
+     *   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

src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java

@@ -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 @@ import sun.nio.ch.FileChannelImpl;
  * 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