United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4530730 : stddoclet: With frames off, window titles have "()" appended

Details
Type:
Bug
Submit Date:
2001-11-22
Status:
Closed
Updated Date:
2002-05-22
Project Name:
JDK
Resolved Date:
2002-04-25
Component:
docs
OS:
solaris_9
Sub-Component:
doclet
CPU:
sparc
Priority:
P5
Resolution:
Fixed
Affected Versions:
1.4.0
Fixed Versions:
1.4.1 (hopper)

Related Reports

Sub Tasks

Description
For the following case,

p4359386/a.java
	/c.java

where

a.java is
==================
package p4359386;

public class a
{
}

c.java is
==========
package p4359386;

public class c
{
}


do a 

javadoc a.java c.java

and observe with Frames OFF, the window title for Package-summary.html has a 0 appended at the end.

                                    

Comments
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
hopper

FIXED IN:
hopper

INTEGRATED IN:
hopper

VERIFIED IN:
hopper-beta


                                     
2004-06-14
EVALUATION

Should be a simple fix
###@###.### 2002-01-03

I created a.java and c.java and ran javadoc 1.4.0:

% javadoc a.java c.java -d doc

Results: The doc/p/package-summary.html page contains the following HTML:
(clutter omitted)

<HEAD>
<TITLE>
p()
</TITLE>
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="p()";
}
</SCRIPT>

What he thought was a zero "0" is actually a pair of parentheses.

-------
An interesting aside...
What goes inside the parentheses is the -windowtitle:

% javadoc a.java c.java -d doc -windowtitle "hi"

Results:

<TITLE>
p(hi)
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../stylesheet.css" TITLE="Style">
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="p(hi)";
}
</SCRIPT>


In the J2SE, for a package page, the same thing happens, where
there is no space ahead of the parenthesis.

<TITLE>
java.applet(Java 2 Platform SE v1.4.0)
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
</HEAD>
<SCRIPT>
function asd()
{
parent.document.title="java.applet(Java 2 Platform SE v1.4.0)";
}
</SCRIPT>


Fixed.  Remove the parentheses when they are empty, 
and add a space ahead of the parentheses when they are present.

###@###.### 2002-03-09

Changed synopsis from:
  stddoclet: With frames-off, window name for package-summary.html has 0 appended
to:
  stddoclet: With frames off, window titles have "()" appended

Refactored the code to put common code into 
HtmlStandardWriter.printHeader(String).
This also makes it consistent across all window titles.

###@###.### 2002-03-23

Changed status from "Fixed" to "FIP" because it hasn't been put back yet.
###@###.### 2002-04-04

Putback on or about April 13.  Regression test is test/com/sun/javadoc/WindowTitles/WindowTitle.java.  
Marking fixed.
###@###.### 2002-04-17

Marked fixed (again?)
###@###.### 2002-04-22
                                     
2002-04-17



Hardware and Software, Engineered to Work Together