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: 4530730
Votes 0
Synopsis stddoclet: With frames off, window titles have "()" appended
Category doclet:tbd
Reported Against merlin-beta3
Release Fixed 1.4.1(hopper)
State 10-Fix Delivered, Verified, bug
Priority: 5-Very Low
Related Bugs
Submit Date 22-NOV-2001
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.
Work Around
N/A
Evaluation
Should be a simple fix
  xxxxx@xxxxx   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.

  xxxxx@xxxxx   2002-03-09

Changed synopsis from:
  stddoclet: With frames-off, window name for package-summary.html has 0 appended

  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.

  xxxxx@xxxxx   2002-03-23

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

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

Marked fixed (again?)
  xxxxx@xxxxx   2002-04-22
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang