Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
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
  
  Include a link with my name & email   

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