United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4434834 : javadoc tool: non .java filenames are taken by default as package names.

Details
Type:
Bug
Submit Date:
2001-04-06
Status:
Closed
Updated Date:
2002-06-27
Project Name:
JDK
Resolved Date:
2002-03-08
Component:
tools
OS:
solaris_8
Sub-Component:
javadoc(tool)
CPU:
sparc
Priority:
P5
Resolution:
Fixed
Affected Versions:
1.4.0
Fixed Versions:
1.4.1 (hopper)

Related Reports

Sub Tasks

Description
The new javadoc correctly does not allow non ".java" files as they were in old Javadoc. Any file with non ".java" extension is rejected. But the error message needs more clarity. Please find the command and the message attached below.
==============================================================================
blr-sunray:/home/vr128054/jdk-latest/jdk1.4.0/src/javax/swing 654 % java   -Dfile.encoding=EUC-JP   -Xbootclasspath/p:/home/vr128054/gj/gjclasses3   -classpath /home/vr128054/gj/gjclasses3   com.sun.tools.javadoc.Main JPanel.xxx
Loading source files for package JPanel.xxx...
javadoc: No source files for package JPanel/xxx 
1 error
================================================================================
While it is perfectly valid to reject .xxx extension, by default, a "." shouldnt
be considered a package name delimiter. A filename level error message could be more informative.

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
hopper

FIXED IN:
hopper

INTEGRATED IN:
hopper

VERIFIED IN:
hopper


                                     
2004-06-14
SUGGESTED FIX

While encountering a non ".java" extension, a simple check to find whether it's a file or a directory can help add more clarity.

If it is a file,
	print error messge "only '.java' files are accepted" 
else
	consider it a package and proceed.
                                     
2004-06-11
PUBLIC COMMENTS

..
                                     
2004-06-10
EVALUATION

On the contrary: the "." IS the package delimiter.  We only
make a special case of handling ".java" to treat it as a file name.

However, in a command such as
	javadoc a/b.c
where a/b.c could neither be a valid source file name nor a package name, we
should just say so.

neal.gafter@Eng 2001-04-11
                                     
2001-04-11



Hardware and Software, Engineered to Work Together