8285890: Fix some @param tags

Reviewed-by: dfuchs, mullan, darcy, mchung, wetmore

Author: pavelrappo

src/java.base/share/classes/java/lang/Shutdown.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1999, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2022, 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,11 +70,11 @@ private static class Lock { };
      * be added to the delete on exit list by the application shutdown
      * hooks.
      *
-     * @params slot  the slot in the shutdown hook array, whose element
-     *               will be invoked in order during shutdown
-     * @params registerShutdownInProgress true to allow the hook
-     *               to be registered even if the shutdown is in progress.
-     * @params hook  the hook to be registered
+     * @param slot  the slot in the shutdown hook array, whose element
+     *              will be invoked in order during shutdown
+     * @param registerShutdownInProgress true to allow the hook
+     *              to be registered even if the shutdown is in progress.
+     * @param hook  the hook to be registered
      *
      * @throws IllegalStateException
      *         if registerShutdownInProgress is false and shutdown is in progress; or

src/java.base/share/classes/java/lang/StackStreamFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2015, 2022, 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
@@ -376,8 +376,8 @@ private R beginStackWalk() {
         /*
          * Fetches stack frames.
          *
-         * @params batchSize number of elements of the frame  buffers for this batch
-         * @returns number of frames fetched in this batch
+         * @param batchSize number of elements of the frame buffers for this batch
+         * @return number of frames fetched in this batch
          */
         private int fetchStackFrames(int batchSize) {
             int startIndex = frameBuffer.startIndex();

src/java.base/share/classes/java/lang/ref/PhantomReference.java

@@ -45,7 +45,7 @@
  * phantom reference always returns {@code null}.
  * The {@link #refersTo(Object) refersTo} method can be used to test
  * whether some object is the referent of a phantom reference.
- * @param<T> the type of the referent
+ * @param <T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.base/share/classes/java/lang/ref/Reference.java

@@ -36,7 +36,7 @@
  * operations common to all reference objects.  Because reference objects are
  * implemented in close cooperation with the garbage collector, this class may
  * not be subclassed directly.
- * @param<T> the type of the referent
+ * @param <T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.base/share/classes/java/lang/ref/ReferenceQueue.java

@@ -31,7 +31,7 @@
 /**
  * Reference queues, to which registered reference objects are appended by the
  * garbage collector after the appropriate reachability changes are detected.
- * @param<T> the type of the reference object
+ * @param <T> the type of the reference object
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.base/share/classes/java/lang/ref/SoftReference.java

@@ -56,7 +56,7 @@
  * prevent its most recently used entries from being discarded by keeping
  * strong referents to those entries, leaving the remaining entries to be
  * discarded at the discretion of the garbage collector.
- * @param<T> the type of the referent
+ * @param <T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.base/share/classes/java/lang/ref/WeakReference.java

@@ -40,7 +40,7 @@
  * weakly-reachable objects to be finalizable.  At the same time or at some
  * later time it will enqueue those newly-cleared weak references that are
  * registered with reference queues.
- * @param<T> the type of the referent
+ * @param <T> the type of the referent
  *
  * @author   Mark Reinhold
  * @since    1.2

src/java.security.jgss/share/classes/sun/security/jgss/GSSHeader.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2022, 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
@@ -280,7 +280,7 @@ private int getLength(int lenByte, InputStream in) throws IOException {
     /**
      * Put the encoding of the length in the specified stream.
      *
-     * @params len the length of the attribute.
+     * @param len the length of the attribute.
      * @param out the outputstream to write the length to
      * @return the number of bytes written
      * @exception IOException on writing errors.