changeset 54796:ec5e5bc74f17

8214823: Javadoc cleanup of java.awt.desktop package Reviewed-by: prr
author serb
date Sat, 02 Feb 2019 10:00:05 -0800
parents 9b93a6b30cbe
children 0c339d151cdc
files src/java.desktop/share/classes/java/awt/desktop/AboutEvent.java src/java.desktop/share/classes/java/awt/desktop/AboutHandler.java src/java.desktop/share/classes/java/awt/desktop/AppEvent.java src/java.desktop/share/classes/java/awt/desktop/AppForegroundEvent.java src/java.desktop/share/classes/java/awt/desktop/AppForegroundListener.java src/java.desktop/share/classes/java/awt/desktop/AppHiddenEvent.java src/java.desktop/share/classes/java/awt/desktop/AppHiddenListener.java src/java.desktop/share/classes/java/awt/desktop/AppReopenedEvent.java src/java.desktop/share/classes/java/awt/desktop/AppReopenedListener.java src/java.desktop/share/classes/java/awt/desktop/FilesEvent.java src/java.desktop/share/classes/java/awt/desktop/OpenFilesEvent.java src/java.desktop/share/classes/java/awt/desktop/OpenFilesHandler.java src/java.desktop/share/classes/java/awt/desktop/OpenURIEvent.java src/java.desktop/share/classes/java/awt/desktop/OpenURIHandler.java src/java.desktop/share/classes/java/awt/desktop/PreferencesEvent.java src/java.desktop/share/classes/java/awt/desktop/PreferencesHandler.java src/java.desktop/share/classes/java/awt/desktop/PrintFilesEvent.java src/java.desktop/share/classes/java/awt/desktop/PrintFilesHandler.java src/java.desktop/share/classes/java/awt/desktop/QuitEvent.java src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java src/java.desktop/share/classes/java/awt/desktop/QuitResponse.java src/java.desktop/share/classes/java/awt/desktop/QuitStrategy.java src/java.desktop/share/classes/java/awt/desktop/ScreenSleepEvent.java src/java.desktop/share/classes/java/awt/desktop/ScreenSleepListener.java src/java.desktop/share/classes/java/awt/desktop/SystemEventListener.java src/java.desktop/share/classes/java/awt/desktop/SystemSleepEvent.java src/java.desktop/share/classes/java/awt/desktop/SystemSleepListener.java src/java.desktop/share/classes/java/awt/desktop/UserSessionEvent.java src/java.desktop/share/classes/java/awt/desktop/UserSessionListener.java
diffstat 29 files changed, 191 insertions(+), 122 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.desktop/share/classes/java/awt/desktop/AboutEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AboutEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -33,11 +33,13 @@
  * Event sent when the application is asked to open its about window.
  *
  * @see AboutHandler#handleAbout
- *
  * @since 9
  */
 public final class AboutEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -5987180734802756477L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/AboutHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AboutHandler.java	Sat Feb 02 10:00:05 2019 -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
@@ -29,8 +29,7 @@
  * An implementer receives notification when the app is asked to show its about
  * dialog.
  *
- * @see java.awt.Desktop#setAboutHandler(java.awt.desktop.AboutHandler)
- *
+ * @see java.awt.Desktop#setAboutHandler(AboutHandler)
  * @since 9
  */
 public interface AboutHandler {
@@ -38,7 +37,7 @@
     /**
      * Called when the application is asked to show its about dialog.
      *
-     * @param e the request to show the about dialog.
+     * @param  e the request to show the about dialog
      */
-    public void handleAbout(final AboutEvent e);
+    public void handleAbout(AboutEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/AppEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -38,6 +38,9 @@
  */
 public class AppEvent extends EventObject {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -5958503993556009432L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/AppForegroundEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppForegroundEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -35,11 +35,13 @@
  *
  * @see AppForegroundListener#appRaisedToForeground(AppForegroundEvent)
  * @see AppForegroundListener#appMovedToBackground(AppForegroundEvent)
- *
  * @since 9
  */
 public final class AppForegroundEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -5513582555740533911L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/AppForegroundListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppForegroundListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -34,17 +34,19 @@
  * @since 9
  */
 public interface AppForegroundListener extends SystemEventListener {
+
     /**
      * Called when the app becomes the foreground app.
-     * @param e event
+     *
+     * @param  e event
      */
-    public void appRaisedToForeground(final AppForegroundEvent e);
+    public void appRaisedToForeground(AppForegroundEvent e);
 
     /**
      * Called when the app becomes the background app and another app becomes
      * the foreground app.
      *
-     * @param e event
+     * @param  e event
      */
-    public void appMovedToBackground(final AppForegroundEvent e);
+    public void appMovedToBackground(AppForegroundEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/AppHiddenEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppHiddenEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -34,11 +34,13 @@
  *
  * @see AppHiddenListener#appHidden(AppHiddenEvent)
  * @see AppHiddenListener#appUnhidden(AppHiddenEvent)
- *
  * @since 9
  */
 public final class AppHiddenEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 2637465279476429224L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/AppHiddenListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppHiddenListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -35,17 +35,17 @@
 public interface AppHiddenListener extends SystemEventListener {
 
     /**
-     * Called the app is hidden.
+     * Called when the app is hidden.
      *
-     * @param e event
+     * @param  e event
      */
-    public void appHidden(final AppHiddenEvent e);
+    public void appHidden(AppHiddenEvent e);
 
     /**
      * Called when the hidden app is shown again (but not necessarily brought to
      * the foreground).
      *
-     * @param e event
+     * @param  e event
      */
-    public void appUnhidden(final AppHiddenEvent e);
+    public void appUnhidden(AppHiddenEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/AppReopenedEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppReopenedEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -33,11 +33,13 @@
  * Event sent when the application is asked to re-open itself.
  *
  * @see AppReopenedListener#appReopened(AppReopenedEvent)
- *
  * @since 9
  */
 public final class AppReopenedEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 1503238361530407990L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/AppReopenedListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/AppReopenedListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -27,15 +27,18 @@
 
 /**
  * Implementors receive notification when the app has been asked to open again.
- *
- * This notification is useful for showing a new document when your app has no open windows.
+ * <p>
+ * This notification is useful for showing a new document when your app has no
+ * open windows.
  *
  * @since 9
  */
 public interface AppReopenedListener extends SystemEventListener {
+
     /**
-     * Called when the app has been reopened
-     * @param e the request to reopen the app
+     * Called when the app has been reopened.
+     *
+     * @param  e the request to reopen the app
      */
-    public void appReopened(final AppReopenedEvent e);
+    public void appReopened(AppReopenedEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/FilesEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/FilesEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -39,7 +39,14 @@
  */
 public class FilesEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 5271763715462312871L;
+
+    /**
+     * The list of files.
+     */
     final List<File> files;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/OpenFilesEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/OpenFilesEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -35,12 +35,18 @@
  * Event sent when the app is asked to open a list of files.
  *
  * @see OpenFilesHandler#openFiles
- *
  * @since 9
  */
 public final class OpenFilesEvent extends FilesEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -3982871005867718956L;
+
+    /**
+     * The search term used to find the files.
+     */
     final String searchTerm;
 
     /**
@@ -63,10 +69,10 @@
     }
 
     /**
-     * Gets the search term. The platform may optionally provide the search
-     * term that was used to find the files. This is for example the case
-     * on Mac OS X, when the files were opened using the Spotlight search
-     * menu or a Finder search window.
+     * Gets the search term. The platform may optionally provide the search term
+     * that was used to find the files. This is for example the case on MacOS,
+     * when the files were opened using the Spotlight search menu or a Finder
+     * search window.
      * <p>
      * This is useful for highlighting the search term in the documents when
      * they are opened.
--- a/src/java.desktop/share/classes/java/awt/desktop/OpenFilesHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/OpenFilesHandler.java	Sat Feb 02 10:00:05 2019 -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
@@ -25,18 +25,20 @@
 
 package java.awt.desktop;
 
-
 /**
- * An implementor is notified when the application is asked to open a list of files.
+ * An implementor is notified when the application is asked to open a list of
+ * files.
  *
- * @see java.awt.Desktop#setOpenFileHandler(java.awt.desktop.OpenFilesHandler)
- *
+ * @see java.awt.Desktop#setOpenFileHandler(OpenFilesHandler)
  * @since 9
  */
 public interface OpenFilesHandler {
+
     /**
      * Called when the application is asked to open a list of files.
-     * @param e the request to open a list of files, and the search term used to find them, if any.
+     *
+     * @param  e the request to open a list of files, and the search term used
+     *         to find them, if any
      */
-    public void openFiles(final OpenFilesEvent e);
+    public void openFiles(OpenFilesEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/OpenURIEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/OpenURIEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -34,12 +34,18 @@
  * Event sent when the app is asked to open a {@code URI}.
  *
  * @see OpenURIHandler#openURI(OpenURIEvent)
- *
  * @since 9
  */
 public final class OpenURIEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 221209100935933476L;
+
+    /**
+     * The {@code URI} the app was asked to open.
+     */
     final URI uri;
 
     /**
@@ -58,7 +64,8 @@
     }
 
     /**
-     * Get the {@code URI} the app was asked to open
+     * Get the {@code URI} the app was asked to open.
+     *
      * @return the {@code URI}
      */
     public URI getURI() {
--- a/src/java.desktop/share/classes/java/awt/desktop/OpenURIHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/OpenURIHandler.java	Sat Feb 02 10:00:05 2019 -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
@@ -28,14 +28,15 @@
 /**
  * An implementor is notified when the application is asked to open a URI.
  *
- * @see java.awt.Desktop#setOpenURIHandler(java.awt.desktop.OpenURIHandler)
- *
+ * @see java.awt.Desktop#setOpenURIHandler(OpenURIHandler)
  * @since 9
  */
 public interface OpenURIHandler {
+
     /**
-     * Called when the application is asked to open a {@code URI}
-     * @param e the request to open a {@code URI}
+     * Called when the application is asked to open a {@code URI}.
+     *
+     * @param  e the request to open a {@code URI}
      */
-    public void openURI(final OpenURIEvent e);
+    public void openURI(OpenURIEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/PreferencesEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/PreferencesEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -33,11 +33,13 @@
  * Event sent when the application is asked to open its preferences window.
  *
  * @see PreferencesHandler#handlePreferences
- *
  * @since 9
  */
 public final class PreferencesEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -6398607097086476160L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/PreferencesHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/PreferencesHandler.java	Sat Feb 02 10:00:05 2019 -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
@@ -28,14 +28,15 @@
 /**
  * An implementor is notified when the app is asked to show its preferences UI.
  *
- * @see java.awt.Desktop#setPreferencesHandler(java.awt.desktop.PreferencesHandler)
- *
+ * @see java.awt.Desktop#setPreferencesHandler(PreferencesHandler)
  * @since 9
  */
 public interface PreferencesHandler {
+
     /**
      * Called when the app is asked to show its preferences UI.
-     * @param e the request to show preferences.
+     *
+     * @param  e the request to show preferences
      */
-    public void handlePreferences(final PreferencesEvent e);
+    public void handlePreferences(PreferencesEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/PrintFilesEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/PrintFilesEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -39,6 +39,9 @@
  */
 public final class PrintFilesEvent extends FilesEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -5752560876153618618L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/PrintFilesHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/PrintFilesHandler.java	Sat Feb 02 10:00:05 2019 -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,16 +26,18 @@
 package java.awt.desktop;
 
 /**
- * An implementor can respond to requests to print documents that the app has been registered to handle.
+ * An implementor can respond to requests to print documents that the app has
+ * been registered to handle.
  *
- * @see java.awt.Desktop#setPrintFileHandler(java.awt.desktop.PrintFilesHandler)
- *
+ * @see java.awt.Desktop#setPrintFileHandler(PrintFilesHandler)
  * @since 9
  */
 public interface PrintFilesHandler {
+
     /**
      * Called when the application is asked to print a list of files.
-     * @param e the request to print a list of files.
+     *
+     * @param  e the request to print a list of files
      */
-    public void printFiles(final PrintFilesEvent e);
+    public void printFiles(PrintFilesEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/QuitEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/QuitEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -33,11 +33,13 @@
  * Event sent when the application is asked to quit.
  *
  * @see QuitHandler#handleQuitRequestWith(QuitEvent, QuitResponse)
- *
  * @since 9
  */
 public final class QuitEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = -256100795532403146L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/QuitHandler.java	Sat Feb 02 10:00:05 2019 -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.
+ * 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)
- *
+ * @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.
+     * <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.
      *
-     * 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);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/QuitResponse.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/QuitResponse.java	Sat Feb 02 10:00:05 2019 -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
@@ -28,21 +28,23 @@
 /**
  * Used to respond to a request to quit the application.
  *
- * @see java.awt.Desktop#setQuitHandler(java.awt.desktop.QuitHandler)
- * @see java.awt.desktop.QuitHandler
- * @see java.awt.Desktop#setQuitStrategy(java.awt.desktop.QuitStrategy)
- *
+ * @see java.awt.Desktop#setQuitHandler(QuitHandler)
+ * @see QuitHandler
+ * @see java.awt.Desktop#setQuitStrategy(QuitStrategy)
  * @since 9
  */
 public interface QuitResponse {
 
     /**
-     * Notifies the external quit requester that the quit will proceed, and performs the default {@link java.awt.desktop.QuitStrategy}.
+     * Notifies the external quit requester that the quit will proceed, and
+     * performs the default {@link QuitStrategy}.
      */
     public void performQuit();
 
     /**
-     * Notifies the external quit requester that the user has explicitly canceled the pending quit, and leaves the application running.
+     * Notifies the external quit requester that the user has explicitly
+     * canceled the pending quit, and leaves the application running.
+     * <p>
      * <b>Note: this will cancel a pending log-out, restart, or shutdown.</b>
      */
     public void cancelQuit();
--- a/src/java.desktop/share/classes/java/awt/desktop/QuitStrategy.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/QuitStrategy.java	Sat Feb 02 10:00:05 2019 -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,18 +26,19 @@
 package java.awt.desktop;
 
 /**
- * The strategy used to shut down the application, if Sudden Termination is not enabled.
+ * The strategy used to shut down the application, if Sudden Termination is not
+ * enabled.
  *
- * @see java.awt.Desktop#setQuitHandler(java.awt.desktop.QuitHandler)
- * @see java.awt.Desktop#setQuitStrategy(java.awt.desktop.QuitStrategy)
+ * @see java.awt.Desktop#setQuitHandler(QuitHandler)
+ * @see java.awt.Desktop#setQuitStrategy(QuitStrategy)
  * @see java.awt.Desktop#enableSuddenTermination()
  * @see java.awt.Desktop#disableSuddenTermination()
- *
  * @since 9
  */
 public enum QuitStrategy {
     /**
-     * Shuts down the application by calling {@code System.exit(0)}. This is the default strategy.
+     * Shuts down the application by calling {@code System.exit(0)}. This is the
+     * default strategy.
      */
     NORMAL_EXIT,
 
--- a/src/java.desktop/share/classes/java/awt/desktop/ScreenSleepEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/ScreenSleepEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -35,11 +35,13 @@
  *
  * @see ScreenSleepListener#screenAboutToSleep(ScreenSleepEvent)
  * @see ScreenSleepListener#screenAwoke(ScreenSleepEvent)
- *
  * @since 9
  */
 public final class ScreenSleepEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 7521606180376544150L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/ScreenSleepListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/ScreenSleepListener.java	Sat Feb 02 10:00:05 2019 -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,9 +26,11 @@
 package java.awt.desktop;
 
 /**
- * Implementors receive notification when the displays attached to the system have entered power save sleep.
- *
- * This notification is useful for discontinuing a costly animation, or indicating that the user is no longer present on a network service.
+ * Implementors receive notification when the displays attached to the system
+ * have entered power save sleep.
+ * <p>
+ * This notification is useful for discontinuing a costly animation, or
+ * indicating that the user is no longer present on a network service.
  *
  * @since 9
  */
@@ -36,13 +38,15 @@
 
     /**
      * Called when the system displays have entered power save sleep.
-     * @param e the screen sleep event
+     *
+     * @param  e the screen sleep event
      */
-    public void screenAboutToSleep(final ScreenSleepEvent e);
+    public void screenAboutToSleep(ScreenSleepEvent e);
 
     /**
      * Called when the system displays have awoken from power save sleep.
-     * @param e the screen sleep event
+     *
+     * @param  e the screen sleep event
      */
-    public void screenAwoke(final ScreenSleepEvent e);
+    public void screenAwoke(ScreenSleepEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/SystemEventListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/SystemEventListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -28,9 +28,8 @@
 import java.util.EventListener;
 
 /**
- * Common interface for all event listener sub-types.
- *
- * Implementors may implement multiple sub-types, but only need to call
+ * Common interface for all event listener sub-types. Implementors may implement
+ * multiple sub-types, but only need to call
  * {@link java.awt.Desktop#addAppEventListener(SystemEventListener)} once to
  * receive all notifications.
  *
--- a/src/java.desktop/share/classes/java/awt/desktop/SystemSleepEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/SystemSleepEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -34,11 +34,13 @@
  *
  * @see SystemSleepListener#systemAboutToSleep(SystemSleepEvent)
  * @see SystemSleepListener#systemAwoke(SystemSleepEvent)
- *
  * @since 9
  */
 public final class SystemSleepEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 11372269824930549L;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/SystemSleepListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/SystemSleepListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -28,7 +28,7 @@
 /**
  * Implementors receive notification as the system is entering sleep, and after
  * the system wakes.
- *
+ * <p>
  * This notification is useful for disconnecting from network services prior to
  * sleep, or re-establishing a connection if the network configuration has
  * changed during sleep.
@@ -42,14 +42,14 @@
      * delivered prior to the actual system sleep, and may be processed after
      * the corresponding wake has occurred.
      *
-     * @param e the system sleep event
+     * @param  e the system sleep event
      */
-    public void systemAboutToSleep(final SystemSleepEvent e);
+    public void systemAboutToSleep(SystemSleepEvent e);
 
     /**
      * Called after the system has awoken from sleeping.
      *
-     * @param e the system sleep event
+     * @param  e the system sleep event
      */
-    public void systemAwoke(final SystemSleepEvent e);
+    public void systemAwoke(SystemSleepEvent e);
 }
--- a/src/java.desktop/share/classes/java/awt/desktop/UserSessionEvent.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/UserSessionEvent.java	Sat Feb 02 10:00:05 2019 -0800
@@ -30,19 +30,23 @@
 import java.awt.HeadlessException;
 
 /**
- * Event sent when the user session has been changed.
- *
- * Some systems may provide a reason of a user session change.
+ * Event sent when the user session has been changed. Some systems may provide a
+ * reason of a user session change.
  *
  * @see UserSessionListener#userSessionActivated(UserSessionEvent)
  * @see UserSessionListener#userSessionDeactivated(UserSessionEvent)
- *
  * @since 9
  */
 public final class UserSessionEvent extends AppEvent {
 
+    /**
+     * Use serialVersionUID from JDK 9 for interoperability.
+     */
     private static final long serialVersionUID = 6747138462796569055L;
 
+    /**
+     * The reason of the user session change.
+     */
     private final Reason reason;
 
     /**
--- a/src/java.desktop/share/classes/java/awt/desktop/UserSessionListener.java	Fri Feb 01 15:34:53 2019 -0800
+++ b/src/java.desktop/share/classes/java/awt/desktop/UserSessionListener.java	Sat Feb 02 10:00:05 2019 -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
@@ -25,32 +25,33 @@
 
 package java.awt.desktop;
 
-
 /**
  * Implementors receive notification when the user session changes.
- *
- * This notification is useful for discontinuing a costly animation,
- * or indicating that the user is no longer present on a network service.
- *
+ * <p>
+ * This notification is useful for discontinuing a costly animation, or
+ * indicating that the user is no longer present on a network service.
+ * <p>
  * Some systems may provide a reason of the user session change.
  *
  * @see UserSessionEvent.Reason#UNSPECIFIED
  * @see UserSessionEvent.Reason#CONSOLE
  * @see UserSessionEvent.Reason#REMOTE
  * @see UserSessionEvent.Reason#LOCK
- *
  * @since 9
  */
 public interface UserSessionListener extends SystemEventListener {
+
     /**
      * Called when the user session has been switched away.
-     * @param e the user session switch event
+     *
+     * @param  e the user session switch event
      */
-    public void userSessionDeactivated(final UserSessionEvent e);
+    public void userSessionDeactivated(UserSessionEvent e);
 
     /**
      * Called when the user session has been switched to.
-     * @param e the user session switch event
+     *
+     * @param  e the user session switch event
      */
-    public void userSessionActivated(final UserSessionEvent e);
+    public void userSessionActivated(UserSessionEvent e);
 }