Name: bsC130419 Date: 06/05/2001


java version "1.4.0-beta"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta-b65)
Java HotSpot(TM) Client VM (build 1.4.0-beta-b65, mixed mode)

Some of the new methods in JDK1.4 are not marked as such using the "@since"
javadoc tag. For example, Runtime.availableProcessors() and Runtime.maxMemory().

There are so many changes in 1.4 that it is very difficult to track them all
down and we need the javadoc to help in this department. Please ensure that
everyone marks new methods as being new using @since. And while they are at it,
ensure that any methods whose contracts have changed significantly are also
clearly documented as such.

Thanks - the Java authors of the world will greatly appreciate this.
(Review ID: 125799)
======================================================================

Name: rmT116609 Date: 11/02/2001


Current docs for JDK 1.4 beta3 is missing Since1.4 keyword in get/setSurrendersFocusOnKeystroke

http://java.sun.com/j2se/1.4/docs/api/javax/swing/JTable.html#setSurrendersFocusOnKeystroke(boolean)

http://java.sun.com/j2se/1.4/docs/api/javax/swing/JTable.html#getSurrendersFocusOnKeystroke()
(Review ID: 134904)
======================================================================

Name: rmT116609 Date: 11/17/2001



The new constants in java.awt.Color, like BLACK, RED, etc. are not marked as being new in the 1.4 JDK. Maybe this is true for fields/methods in
other classes as well throughout the JDK. This can become very anoying because it means that I either have to work with older documentation, if
I want to be 1.2 conform or I have to run every little piece of my applications under 1.2 just to find out whether it is compatible.
(Review ID: 135859)
======================================================================

Name: rmT116609 Date: 01/04/2002



http://java.sun.com/j2se/1.4/docs/api/java/net/ServerSocket.html#ServerSocket()

The no parameter constructor for java.net.ServerSocket is
new "Since: JDK1.4".

Bug: Please say so via javadoc @since.




(Review ID: 137854)
======================================================================

Name: rmT116609 Date: 02/21/2002


DESCRIPTION OF THE PROBLEM :

http://java.sun.com/j2se/1.4/docs/api/java/net/URLEncoder.html#encode(java.lang.String, java.lang.String)

The documentation for java.net.URLEncoder.encode(String s, String enc) lacks the "@since 1.4.0" keyword. This is a new method and the previous method
java.net.URLEncoder.encode(String s) was deprecated, causing
deprecation errors on code that compiled fine in 1.3.1.

For developers to find out what the impact of changing to the new method would be, they need to know the version in which the new function was added.
(Review ID: 143169)
======================================================================

Name: rmT116609 Date: 03/10/2002


URLEncoder/Decoder since jdk 1.4 is missing

Documentation of URLEncoder.encode(String, String) and URLDecoder.decode(String, String)should contain a @since tag;
(Review ID: 143972)
======================================================================

Name: rmT116609 Date: 03/21/2002


 DESCRIPTION OF THE PROBLEM :
Since section is missing from the online documentation for the java.net.URISyntaxException class

The page in question is:

http://java.sun.com/j2se/1.4/docs/api/java/net/URISyntaxException.html

EXPECTED VERSUS ACTUAL BEHAVIOR :

Expected:

   Since:
      1.4

Actual:

There is no 'Since' section included in the documentation. It is probabily just an ommision. But it is an inconsistency and it is useful information.

(Review ID: 144445)
======================================================================

Name: rmT116609 Date: 05/23/2002



http://java.sun.com/j2se/1.4/docs/api/javax/swing/JOptionPane.html#showInputDialog(java.awt.Component, java.lang.Object, java.lang.Object)

Expected : since 1.4


(Review ID: 144705)
======================================================================

Name: rmT116609 Date: 06/23/2002


 DESCRIPTION OF THE PROBLEM :
Apparently the VolatileImage has been introduced in the 1.4 version of J2SE.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Open VolatileImage api documentation:
jdk/docs/api/java/awt/image/VolatileImage.html

/*
http://java.sun.com/j2se/1.4/docs/api/java/awt/image/VolatileImage.html
http://java.sun.com/j2se/1.4.1/docs/api/java/awt/image/VolatileImage.html

*/


2. Notice that there's no information as to when the class VolatileImage was first introduced.

EXPECTED VERSUS ACTUAL BEHAVIOR :
An information about the version of J2SE where VolatileImage was introduced should be present in the form of a @since tag in the java doc comments in the source code.

(Review ID: 158306)
======================================================================