archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-28 07:14:30 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8251123: doclint warnings about missing javadoc tags and comments

Browse source 
Reviewed-by: jdv, prr
This commit is contained in:
Sergey Bylokhov 2020-10-06 10:49:56 +00:00
parent c9d1dcc63d
commit f397b60ae1
69 changed files with 1095 additions and 451 deletions
Download patch file Download diff file Expand all files Collapse all files

5
src/java.desktop/share/classes/java/awt/event/FocusEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2020, 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
@ -381,6 +381,9 @@ public class FocusEvent extends ComponentEvent {
* {@link Cause#UNKNOWN} and its other fields have the same values as in
* this {@code FocusEvent} instance.
*
* @return a newly created object from deserialized data
* @throws ObjectStreamException if a new object replacing this object could
* not be created
* @serial
* @see #cause
* @since 9

18
src/java.desktop/share/classes/java/awt/event/HierarchyEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2008, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 2020, 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
@ -162,9 +162,23 @@ public class HierarchyEvent extends AWTEvent {
*/
public static final int SHOWING_CHANGED = 0x4;
/**
* The {@code Component} at the top of the hierarchy which was changed.
*/
Component changed;
/**
* The parent of the {@code changed} component. This may be the parent
* before or after the change, depending on the type of change.
*/
Container changedParent;
long changeFlags;
/**
* A bitmask which indicates the type(s) of the {@code HIERARCHY_CHANGED}
* events represented in this event object. For information on allowable
* values, see the class description for {@link HierarchyEvent}
*/
long changeFlags;
/**
* Constructs an {@code HierarchyEvent} object to identify a

17
src/java.desktop/share/classes/java/awt/event/InputMethodEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2020, 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,19 +25,19 @@
package java.awt.event;
import sun.awt.AWTAccessor;
import sun.awt.AppContext;
import sun.awt.SunToolkit;
import java.awt.AWTEvent;
import java.awt.Component;
import java.awt.EventQueue;
import java.awt.font.TextHitInfo;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.lang.annotation.Native;
import java.text.AttributedCharacterIterator;
import java.text.CharacterIterator;
import java.lang.annotation.Native;
import sun.awt.AWTAccessor;
import sun.awt.AppContext;
import sun.awt.SunToolkit;
/**
* Input method events contain information about text that is being
@ -414,6 +414,11 @@ public class InputMethodEvent extends AWTEvent {
* Initializes the {@code when} field if it is not present in the
* object input stream. In that case, the field will be initialized by
* invoking {@link java.awt.EventQueue#getMostRecentEventTime()}.
*
* @param s the {@code ObjectInputStream} to read
* @throws ClassNotFoundException if the class of a serialized object could
* not be found
* @throws IOException if an I/O error occurs
*/
private void readObject(ObjectInputStream s) throws ClassNotFoundException, IOException {
s.defaultReadObject();

8
src/java.desktop/share/classes/java/awt/event/KeyEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2020, 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
@ -30,6 +30,7 @@ import java.awt.GraphicsEnvironment;
import java.awt.Toolkit;
import java.io.IOException;
import java.io.ObjectInputStream;
import sun.awt.AWTAccessor;
/**
@ -1878,6 +1879,11 @@ public class KeyEvent extends InputEvent {
/**
* Sets new modifiers by the old ones. The key modifiers
* override overlapping mouse modifiers.
*
* @param s the {@code ObjectInputStream} to read
* @throws ClassNotFoundException if the class of a serialized object could
* not be found
* @throws IOException if an I/O error occurs
* @serial
*/
@SuppressWarnings("deprecation")

10
src/java.desktop/share/classes/java/awt/event/MouseEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2020, 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,12 +27,11 @@ package java.awt.event;
import java.awt.Component;
import java.awt.GraphicsEnvironment;
import java.awt.IllegalComponentStateException;
import java.awt.Point;
import java.awt.Toolkit;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.awt.IllegalComponentStateException;
import java.awt.MouseInfo;
import sun.awt.AWTAccessor;
import sun.awt.SunToolkit;
@ -1188,6 +1187,11 @@ public class MouseEvent extends InputEvent {
/**
* Sets new modifiers by the old ones.
*
* @param s the {@code ObjectInputStream} to read
* @throws ClassNotFoundException if the class of a serialized object could
* not be found
* @throws IOException if an I/O error occurs
* @serial
*/
@SuppressWarnings("deprecation")

10
src/java.desktop/share/classes/java/awt/event/WindowEvent.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2020, 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,6 +27,7 @@ package java.awt.event;
import java.awt.Window;
import java.lang.annotation.Native;
import sun.awt.AppContext;
import sun.awt.SunToolkit;
@ -163,11 +164,14 @@ public class WindowEvent extends ComponentEvent {
transient Window opposite;
/**
* TBS
* Previous state of the window for window state change event.
*/
int oldState;
int newState;
/**
* New state of the window for window state change event.
*/
int newState;
/*
* JDK 1.1 serialVersionUID