--- old/src/java.smartcardio/share/classes/javax/smartcardio/Card.java	2015-04-15 17:36:52.968106843 -0700
+++ new/src/java.smartcardio/share/classes/javax/smartcardio/Card.java	2015-04-15 17:36:52.760106838 -0700
@@ -69,6 +69,7 @@
      * Returns the CardChannel for the basic logical channel. The basic
      * logical channel has a channel number of 0.
      *
+     * @return the CardChannel for the basic logical channel
      * @throws SecurityException if a SecurityManager exists and the
      *   caller does not have the required
      *   {@linkplain CardPermission permission}
@@ -82,6 +83,7 @@
      * opened by issuing a <code>MANAGE CHANNEL</code> command that should use
      * the format <code>[00 70 00 00 01]</code>.
      *
+     * @return the card to which a logical channel has been opened
      * @throws SecurityException if a SecurityManager exists and the
      *   caller does not have the required
      *   {@linkplain CardPermission permission}
@@ -137,6 +139,7 @@
      *
      * @param controlCode the control code of the command
      * @param command the command data
+     * @return the response from the terminal device
      *
      * @throws SecurityException if a SecurityManager exists and the
      *   caller does not have the required
--- old/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminal.java	2015-04-15 17:36:53.396106853 -0700
+++ new/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminal.java	2015-04-15 17:36:53.224106849 -0700
@@ -83,6 +83,7 @@
      * @throws SecurityException if a SecurityManager exists and the
      *   caller does not have the required
      *   {@linkplain CardPermission permission}
+     * @return the card the connection has been established with
      */
     public abstract Card connect(String protocol) throws CardException;
 
--- old/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminals.java	2015-04-15 17:36:53.856106863 -0700
+++ new/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminals.java	2015-04-15 17:36:53.684106859 -0700
@@ -105,6 +105,7 @@
      * Returns the terminal with the specified name or null if no such
      * terminal exists.
      *
+     * @param name the terminal name
      * @return the terminal with the specified name or null if no such
      * terminal exists.
      *