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

*** 67,76 ****
--- 67,77 ----
  
      /**
       * 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,89 ****
--- 81,91 ----
      /**
       * 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,144 ****
--- 137,147 ----
       * <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