--- old/src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java 2018-12-04 16:22:46.000000000 -0800 +++ new/src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java 2018-12-04 16:22:46.000000000 -0800 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2016, 2018, 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 @@ -26,26 +26,32 @@ package java.awt.desktop; /** - * An implementor determines if requests to quit this application should proceed or cancel. - * - * @see java.awt.Desktop#setQuitHandler(java.awt.desktop.QuitHandler) - * @see java.awt.Desktop#setQuitStrategy(java.awt.desktop.QuitStrategy) + * An implementor determines if requests to quit this application should proceed + * or cancel. * + * @see java.awt.Desktop#setQuitHandler(QuitHandler) + * @see java.awt.Desktop#setQuitStrategy(QuitStrategy) * @since 9 */ public interface QuitHandler { + /** * Invoked when the application is asked to quit. + *

+ * Implementors must call either {@link QuitResponse#cancelQuit()}, + * {@link QuitResponse#performQuit()}, or ensure the application terminates. + * The process (or log-out) requesting this app to quit will be blocked + * until the {@link QuitResponse} is handled. Apps that require complex UI + * to shutdown may call the {@link QuitResponse} from any thread. Your app + * may be asked to quit multiple times before you have responded to the + * initial request. This handler is called each time a quit is requested, + * and the same {@link QuitResponse} object is passed until it is handled. + * Once used, the {@link QuitResponse} cannot be used again to change the + * decision. * - * Implementors must call either {@link QuitResponse#cancelQuit()}, {@link QuitResponse#performQuit()}, or ensure the application terminates. - * The process (or log-out) requesting this app to quit will be blocked until the {@link QuitResponse} is handled. - * Apps that require complex UI to shutdown may call the {@link QuitResponse} from any thread. - * Your app may be asked to quit multiple times before you have responded to the initial request. - * This handler is called each time a quit is requested, and the same {@link QuitResponse} object is passed until it is handled. - * Once used, the {@link QuitResponse} cannot be used again to change the decision. - * - * @param e the request to quit this application. - * @param response the one-shot response object used to cancel or proceed with the quit action. + * @param e the request to quit this application + * @param response the one-shot response object used to cancel or proceed + * with the quit action */ - public void handleQuitRequestWith(final QuitEvent e, final QuitResponse response); + public void handleQuitRequestWith(QuitEvent e, QuitResponse response); }