src/java.security.jgss/share/classes/org/ietf/jgss/GSSCredential.java

*** 33,43 ****
   * credential elements, each containing information for a specific
   * security mechanism, but all referring to the same entity. A credential
   * may be used to perform context initiation, acceptance, or both.<p>
   *
   * Credentials are instantiated using one of the
!  * <code>createCredential</code> methods in the {@link GSSManager
   * GSSManager} class. GSS-API credential creation is not
   * intended to provide a "login to the network" function, as such a
   * function would involve the creation of new credentials rather than
   * merely acquiring a handle to existing credentials. The
   * <a href=package-summary.html#useSubjectCredsOnly>section on credential
--- 33,43 ----
   * credential elements, each containing information for a specific
   * security mechanism, but all referring to the same entity. A credential
   * may be used to perform context initiation, acceptance, or both.<p>
   *
   * Credentials are instantiated using one of the
!  * {@code createCredential} methods in the {@link GSSManager
   * GSSManager} class. GSS-API credential creation is not
   * intended to provide a "login to the network" function, as such a
   * function would involve the creation of new credentials rather than
   * merely acquiring a handle to existing credentials. The
   * <a href=package-summary.html#useSubjectCredsOnly>section on credential
*** 73,83 ****
   *    System.out.println(cred.getName().toString());
   *    System.out.println(cred.getRemainingLifetime());
   *
   *    Oid [] mechs = cred.getMechs();
   *    if (mechs != null) {
!  *            for (int i = 0; i < mechs.length; i++)
   *                    System.out.println(mechs[i].toString());
   *    }
   *
   *    // release system resources held by the credential
   *    cred.dispose();
--- 73,83 ----
   *    System.out.println(cred.getName().toString());
   *    System.out.println(cred.getRemainingLifetime());
   *
   *    Oid [] mechs = cred.getMechs();
   *    if (mechs != null) {
!  *            for (int i = 0; i{@literal <} mechs.length; i++)
   *                    System.out.println(mechs[i].toString());
   *    }
   *
   *    // release system resources held by the credential
   *    cred.dispose();
*** 295,306 ****
       * This routine is envisioned to be used mainly by context acceptors
       * during the creation of acceptor credentials which are to be used
       * with a variety of clients using different security mechanisms.<p>
       *
       * This routine adds the new credential element "in-place".  To add the
!      * element in a new credential, first call <code>clone</code> to obtain a
!      * copy of this credential, then call its <code>add</code> method.<p>
       *
       * As always, GSS-API implementations must impose a local access-control
       * policy on callers to prevent unauthorized callers from acquiring
       * credentials to which they are not entitled.
       *
--- 295,306 ----
       * This routine is envisioned to be used mainly by context acceptors
       * during the creation of acceptor credentials which are to be used
       * with a variety of clients using different security mechanisms.<p>
       *
       * This routine adds the new credential element "in-place".  To add the
!      * element in a new credential, first call {@code clone} to obtain a
!      * copy of this credential, then call its {@code add} method.<p>
       *
       * As always, GSS-API implementations must impose a local access-control
       * policy on callers to prevent unauthorized callers from acquiring
       * credentials to which they are not entitled.
       *
*** 309,319 ****
       * prepared to call {@link #getRemainingInitLifetime(Oid)
       * getRemainingInitLifetime} and {@link #getRemainingAcceptLifetime(Oid)
       * getRemainingAcceptLifetime} on the credential.
       *
       * @param name the name of the principal for whom this credential is to
!      * be acquired.  Use <code>null</code> to specify the default
       * principal.
       * @param initLifetime the number of seconds that the credential element
       * should remain valid for initiating of security contexts. Use {@link
       * GSSCredential#INDEFINITE_LIFETIME GSSCredential.INDEFINITE_LIFETIME}
       * to request that the credentials have the maximum permitted lifetime
--- 309,319 ----
       * prepared to call {@link #getRemainingInitLifetime(Oid)
       * getRemainingInitLifetime} and {@link #getRemainingAcceptLifetime(Oid)
       * getRemainingAcceptLifetime} on the credential.
       *
       * @param name the name of the principal for whom this credential is to
!      * be acquired.  Use {@code null} to specify the default
       * principal.
       * @param initLifetime the number of seconds that the credential element
       * should remain valid for initiating of security contexts. Use {@link
       * GSSCredential#INDEFINITE_LIFETIME GSSCredential.INDEFINITE_LIFETIME}
       * to request that the credentials have the maximum permitted lifetime
*** 352,363 ****
      /**
       * Tests if this GSSCredential asserts the same entity as the supplied
       * object.  The two credentials must be acquired over the same
       * mechanisms and must refer to the same principal.
       *
!      * @return <code>true</code> if the two GSSCredentials assert the same
!      * entity; <code>false</code> otherwise.
       * @param another another GSSCredential for comparison to this one
       */
      public boolean equals(Object another);
  
      /**
--- 352,363 ----
      /**
       * Tests if this GSSCredential asserts the same entity as the supplied
       * object.  The two credentials must be acquired over the same
       * mechanisms and must refer to the same principal.
       *
!      * @return {@code true} if the two GSSCredentials assert the same
!      * entity; {@code false} otherwise.
       * @param another another GSSCredential for comparison to this one
       */
      public boolean equals(Object another);
  
      /**