src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java

@@ -1,7 +1,7 @@
 /*
- * 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
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -24,28 +24,34 @@
  */
 
 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.
-     *
-     * @param e the request to quit this application.
-     * @param response the one-shot response object used to cancel or proceed with the quit action.
+     * <p>
+     * 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
      */
-    public void handleQuitRequestWith(final QuitEvent e, final QuitResponse response);
+    public void handleQuitRequestWith(QuitEvent e, QuitResponse response);
 }