United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4869993 Constant Field Value of type long ends in "l" but looks like "1", should be "L"
JDK-4869993 : Constant Field Value of type long ends in "l" but looks like "1", should be "L"

Details
Type:
Bug
Submit Date:
2003-05-27
Status:
Resolved
Updated Date:
2003-10-03
Project Name:
JDK
Resolved Date:
2003-10-03
Component:
tools
OS:
windows_2000
Sub-Component:
javadoc(tool)
CPU:
x86
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0 (tiger)

Related Reports

Sub Tasks

Description

Name: rmT116609			Date: 05/27/2003


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) 
======================================================================

                                    

Comments
EVALUATION

> Any objection to changing the "l" to an uppercase "L" to avoid this confusion? 

###@###.### 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."

###@###.### 2003-05-28

The offending code is in
	src/share/classes/com/sun/tools/javadoc/FieldDocImpl.java
in the method constantValueExpression()

###@###.### 2003-05-28
                                     
2003-05-28
PUBLIC COMMENTS

Fixed as requested by ###@###.### 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

###@###.### 2003-10-02
                                     
2003-10-02
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger

FIXED IN:
tiger

INTEGRATED IN:
tiger


                                     
2004-06-14



Hardware and Software, Engineered to Work Together