8077915: Fix doclint issues in javax.smartcardio
authordarcy
Thu, 16 Apr 2015 10:44:23 -0700
changeset 29928 6ad7fd5f4746
parent 29927 9cc3e111a1d8
child 29929 98aafceddece
8077915: Fix doclint issues in javax.smartcardio Reviewed-by: mullan
jdk/src/java.smartcardio/share/classes/javax/smartcardio/Card.java
jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminal.java
jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminals.java
--- a/jdk/src/java.smartcardio/share/classes/javax/smartcardio/Card.java	Thu Apr 16 09:51:29 2015 -0700
+++ b/jdk/src/java.smartcardio/share/classes/javax/smartcardio/Card.java	Thu Apr 16 10:44:23 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2015, 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
@@ -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 logical channel which 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
--- a/jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminal.java	Thu Apr 16 09:51:29 2015 -0700
+++ b/jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminal.java	Thu Apr 16 10:44:23 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2015, 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
@@ -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;
 
--- a/jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminals.java	Thu Apr 16 09:51:29 2015 -0700
+++ b/jdk/src/java.smartcardio/share/classes/javax/smartcardio/CardTerminals.java	Thu Apr 16 10:44:23 2015 -0700
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2006, 2015, 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
@@ -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.
      *