United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4753853 : "The first sentence" warning split between stderr and stdout

Details
Type:
Bug
Submit Date:
2002-09-26
Status:
Resolved
Updated Date:
2003-08-01
Project Name:
JDK
Resolved Date:
2003-08-01
Component:
tools
OS:
windows_2000
Sub-Component:
javadoc(tool)
CPU:
x86
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.1
Fixed Versions:
5.0 (tiger)

Related Reports

Sub Tasks

Description

Name: rmT116609			Date: 09/26/2002


FULL PRODUCT VERSION :
java version "1.4.1"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1-b21)
Java HotSpot(TM) Client VM (build 1.4.1-b21, mixed mode)

FULL OPERATING SYSTEM VERSION :
Microsoft Windows 2000 [Version 5.00.2195]

A DESCRIPTION OF THE PROBLEM :
The warning that begins "The first sentence is interpreted
to be" reports the header to stderr, but the rest of the
warning is sent to stdout.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Create a Java program with a Javadoc comment before the
main method such as:

  /** This tests the "first sentence" msg. reported by
javadoc. This is a second sentence. */

2. Run javadoc on it (without the -breakiterator option),
redirecting stdout and stderr to two different files:

  javadoc MyTest.java > out.txt 2> err.txt

(Note that there's no way to redirect stderr SFAIK under
Win9x, so I think this requires Win2x to test.)

3. View out.txt and err.txt.


EXPECTED VERSUS ACTUAL BEHAVIOR :
Stderr will show a warning such as:

c:\java\MyTest.java:8: warning - The first sentence is
interpreted to be:

Stdout will contain the rest of the warning:

This tests the "first sentence" msg.
This sentence is different from what will be interpreted as
the first sentence in the
next major release (when that interpretation will be
internationalized), which is:
[etc.]

The whole report should probably go to stderr only.
Otherwise, I'm having to play "Match the Data to the Error
Header".

Arguably, this might not be worth fixing, based on the
description of first sentence detection in the Javadoc
documentation.  That is, the "first sentence" warning may
go away in 1.4.2 or later.  However, this bug may be
occurring for other warnings, so I thought it best to
report it anyway.

ERROR MESSAGES/STACK TRACES THAT OCCUR :
c:\java\MyTest.java:8: warning - The first sentence is interpreted to be:

Source:

/*

public class MyTest {

  /** This tests the "first sentence" msg. reported by
javadoc. This is a second sentence. */


public static void main(String a[]) {

System.out.println("hello");

}
}

*/

REPRODUCIBILITY :
This bug can be reproduced always.
(Review ID: 165008) 
======================================================================

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger

FIXED IN:
tiger

INTEGRATED IN:
tiger
tiger-b14


                                     
2004-06-14
PUBLIC COMMENTS

...
                                     
2004-06-10
EVALUATION

Yes, it should all go out to one place.

###@###.### 2002-10-17

This may have been fixed already.  I'm not sure.  If not, I beleive
the right fix is to use a single resource key for the diagnostic.

###@###.### 2003-04-17
                                     
2002-10-17



Hardware and Software, Engineered to Work Together