src/java.desktop/share/classes/javax/sound/sampled/Control.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1999, 2017, 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
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -46,11 +46,11 @@
      * The control type.
      */
     private final Type type;
 
     /**
-     * Constructs a Control with the specified type.
+     * Constructs a control with the specified type.
      *
      * @param  type the kind of control desired
      */
     protected Control(Type type) {
         this.type = type;

@@ -64,22 +64,21 @@
     public Type getType() {
         return type;
     }
 
     /**
-     * Obtains a String describing the control type and its current state.
+     * Obtains a string describing the control type and its current state.
      *
-     * @return a String representation of the Control
+     * @return a string representation of the control
      */
     @Override
     public String toString() {
         return new String(getType() + " Control");
     }
 
     /**
      * An instance of the {@code Type} class represents the type of the control.
-     * Static instances are provided for the common types.
      */
     public static class Type {
 
         /**
          * Type name.

@@ -96,19 +95,26 @@
         protected Type(String name) {
             this.name = name;
         }
 
         /**
-         * Finalizes the equals method.
+         * Indicates whether the specified object is equal to this control type,
+         * returning {@code true} if the objects are identical.
+         *
+         * @param  obj the reference object with which to compare
+         * @return {@code true} if this control type is the same as the
+         *         {@code obj} argument; {@code false} otherwise
          */
         @Override
         public final boolean equals(Object obj) {
             return super.equals(obj);
         }
 
         /**
-         * Finalizes the hashCode method.
+         * Returns a hash code value for this control type.
+         *
+         * @return a hash code value for this control type
          */
         @Override
         public final int hashCode() {
             return super.hashCode();
         }