United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4396665 : stddoclet: All warnings and errors should show the responsible file

Details
Type:
Bug
Submit Date:
2000-12-09
Status:
Closed
Updated Date:
2014-05-05
Project Name:
JDK
Resolved Date:
2001-07-13
Component:
tools
OS:
solaris_2.6,windows_2000
Sub-Component:
javadoc(tool)
CPU:
x86,sparc,generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.2.2,1.3.0,1.3.1
Fixed Versions:
1.4.0 (beta2)

Related Reports
Duplicate:
Duplicate:

Sub Tasks

Description
Name: rlT66838			Date: 04/13/2000
java version "1.2.2"
Classic VM (build JDK-1.2.2.-001, native threads, symcjit)


The following code and javadoc command displays the following 
warning, which is an example of how it can be extremely hard to find 
the java source code responsible for this bug:

  javadoc: warning - Tag @link: Class or Package not found: Math Math link
  (Review ID: 103623) 

Warnings show up at different places in the output, many times they 
are caused by the same source.  If all warnings and errors showed 
the responsible file, life would be easier.


(another bug #..... 
speaks to the problem with {@link} that causes the warning).

------------------------ CODE ------------------------
package nl.virgil;

import java.lang.*;
import java.lang.Integer;

public class Test {

    /**
     * This {@link Math Math link} won't work, not even when it is fully
     * qualified as this link {@link java.lang.Math} shows, even importing
     * java.lang.* doesn't help.
     * <p>
     * The funny thing is that everything for a {@link String String link}
     * seems to work.
     * <p>
     * You can get it working by importing all classes explicitly as you can
     * see in this {@link Integer Integer link}.
     */
    public Test() {

    }
}

javac nl/virgil/Test.java
javadoc -link http://java.sun.com/products/jdk/1.2/docs/api nl.virgil


                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
merlin-beta2

FIXED IN:
merlin-beta2

INTEGRATED IN:
merlin-beta2

VERIFIED IN:
merlin-beta2


                                     
2004-06-14
EVALUATION

Will investigate and fix for 1.4 beta.
jamie.ho@Eng 2001-05-14

This bug has been fixed.  Location of fix:

AbstractIndexWriter.java 
PackageWriter.java 
ClassWriter.java 
MethodSubWriter.java 
SerialMethodSubWriter.java 
SerialFieldSubWriter.java 
ExecutableMemberSubWriter.java
SubWriterHolderWriter.java 
AbstractSubWriter.java
HtmlStandardWriter.java
standard.properties

jamie.ho@Eng 2001-05-17

Reopenning bug to improve fix.
jamie.ho@Eng 2001-05-17

Location of improved fix:

AbstractIndexWriter.java
ClassWriter.java
ExecutableMemberSubWriter.java
FieldSubWriter.java
HtmlStandardWriter.java
MethodSubWriter.java
PackageWriter.java
SerialFieldSubWriter.java
SerialMethodSubWriter.java
SerializedFormWriter.java
Standard.java
SubWriterHolderWriter.java
MessageRetriever.java

jamie.ho@Eng 2001-07-06
                                     
2001-07-06
PUBLIC COMMENTS

A major effort was made to improve the error/warning messages. 
jamie.ho@Eng 2001-05-17

This bug has been fixed.  The standard doclet now uses SourcePosition to determine the location of errors.
jamie.ho@Eng 2001-07-06
                                     
2001-05-17



Hardware and Software, Engineered to Work Together