|
Quick Lists
|
|
Bug ID:
|
4869993
|
|
Votes
|
0
|
|
Synopsis
|
Constant Field Value of type long ends in "l" but looks like "1", should be "L"
|
|
Category
|
java:javadoctool
|
|
Reported Against
|
mantis-beta
|
|
Release Fixed
|
1.5(tiger)
|
|
State
|
10-Fix Delivered,
bug
|
|
Priority:
|
4-Low
|
|
Related Bugs
|
|
|
Submit Date
|
27-MAY-2003
|
|
Description
|
Fixed as requested by xxxxx@xxxxx as a side-effect of:
4904495: Doclet API: support for annotations and annotation types
Verified by going to:
doc/api/constant-values.html
and searching for:
public static final long ACTION_EVENT_MASK 128L
xxxxx@xxxxx 2003-10-02
FULL PRODUCT VERSION :
java version "1.4.2-beta"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-beta-b19)
Java HotSpot(TM) Client VM (build 1.4.2-beta-b19, mixed mode)
FULL OS VERSION :
Microsoft Windows 2000 [Version 5.00.2195]
A DESCRIPTION OF THE PROBLEM :
The string "public static final long MAX_VALUE 9223372036854775807l" looks like "public static final long MAX_VALUE 92233720368547758071". It should be changed to "public static final long MAX_VALUE 9223372036854775807L".
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Can be seen on JDK's javadoc, e.g.
http://java.sun.com/j2se/1.4.2/docs/api/constant-values.html#java.lang.Long.MAX_VALUE
(Review ID: 186553)
======================================================================
|
|
Work Around
|
N/A
|
|
Evaluation
|
> Any objection to changing the "l" to an uppercase "L" to avoid this confusion?
xxxxx@xxxxx wrote:
Please do. In general we should never use the "small L" prefix, for this reason. I should mention this in the next ed. of my book:)
> (Should we keep other letters lowercase, such as "d"?)
Yes, I think so. It look more "java-like."
xxxxx@xxxxx 2003-05-28
The offending code is in
src/share/classes/com/sun/tools/javadoc/FieldDocImpl.java
in the method constantValueExpression()
xxxxx@xxxxx 2003-05-28
|
|
Comments
|
Submitted On 28-MAY-2003
paulkrause88
It should be noted that this is a problem with javadoc, not
the documentation itself. The URL above is merely one
manifestation.
PLEASE NOTE: JDK6 is formerly known as Project Mustang
|
|
|
 |