src/java.smartcardio/share/classes/javax/smartcardio/Card.java

@@ -67,10 +67,11 @@
 
     /**
      * 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}
      * @throws IllegalStateException if this card object has been disposed of
      *   via the {@linkplain #disconnect disconnect()} method

@@ -80,10 +81,11 @@
     /**
      * Opens a new logical channel to the card and returns it. The channel is
      * 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}
      * @throws CardException is a new logical channel could not be opened
      * @throws IllegalStateException if this card object has been disposed of

@@ -135,10 +137,11 @@
      * <p>This can be used to, for example, control terminal functions like
      * a built-in PIN pad or biometrics.
      *
      * @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
      *   {@linkplain CardPermission permission}
      * @throws NullPointerException if command is null