--- old/src/share/classes/java/security/AuthProvider.java 2013-06-28 10:31:35.510377135 -0700 +++ new/src/share/classes/java/security/AuthProvider.java 2013-06-28 10:31:35.350377137 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2004, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2013, 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 @@ -32,8 +32,8 @@ /** * This class defines login and logout methods for a provider. * - *

While callers may invoke login directly, - * the provider may also invoke login on behalf of callers + *

While callers may invoke {@code login} directly, + * the provider may also invoke {@code login} on behalf of callers * if it determines that a login must be performed * prior to certain operations. * @@ -56,11 +56,11 @@ /** * Log in to this provider. * - *

The provider relies on a CallbackHandler + *

The provider relies on a {@code CallbackHandler} * to obtain authentication information from the caller - * (a PIN, for example). If the caller passes a null + * (a PIN, for example). If the caller passes a {@code null} * handler to this method, the provider uses the handler set in the - * setCallbackHandler method. + * {@code setCallbackHandler} method. * If no handler was set in that method, the provider queries the * auth.login.defaultCallbackHandler security property * for the fully qualified class name of a default handler implementation. @@ -68,21 +68,21 @@ * the provider is assumed to have alternative means * for obtaining authentication information. * - * @param subject the Subject which may contain + * @param subject the {@code Subject} which may contain * principals/credentials used for authentication, * or may be populated with additional principals/credentials * after successful authentication has completed. - * This parameter may be null. - * @param handler the CallbackHandler used by + * This parameter may be {@code null}. + * @param handler the {@code CallbackHandler} used by * this provider to obtain authentication information - * from the caller, which may be null + * from the caller, which may be {@code null} * * @exception LoginException if the login operation fails * @exception SecurityException if the caller does not pass a * security check for - * SecurityPermission("authProvider.name"), - * where name is the value returned by - * this provider's getName method + * {@code SecurityPermission("authProvider.name")}, + * where {@code name} is the value returned by + * this provider's {@code getName} method */ public abstract void login(Subject subject, CallbackHandler handler) throws LoginException; @@ -93,18 +93,18 @@ * @exception LoginException if the logout operation fails * @exception SecurityException if the caller does not pass a * security check for - * SecurityPermission("authProvider.name"), - * where name is the value returned by - * this provider's getName method + * {@code SecurityPermission("authProvider.name")}, + * where {@code name} is the value returned by + * this provider's {@code getName} method */ public abstract void logout() throws LoginException; /** - * Set a CallbackHandler. + * Set a {@code CallbackHandler}. * *

The provider uses this handler if one is not passed to the - * login method. The provider also uses this handler - * if it invokes login on behalf of callers. + * {@code login} method. The provider also uses this handler + * if it invokes {@code login} on behalf of callers. * In either case if a handler is not set via this method, * the provider queries the * auth.login.defaultCallbackHandler security property @@ -113,14 +113,14 @@ * the provider is assumed to have alternative means * for obtaining authentication information. * - * @param handler a CallbackHandler for obtaining - * authentication information, which may be null + * @param handler a {@code CallbackHandler} for obtaining + * authentication information, which may be {@code null} * * @exception SecurityException if the caller does not pass a * security check for - * SecurityPermission("authProvider.name"), - * where name is the value returned by - * this provider's getName method + * {@code SecurityPermission("authProvider.name")}, + * where {@code name} is the value returned by + * this provider's {@code getName} method */ public abstract void setCallbackHandler(CallbackHandler handler); }