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: 4417174
Votes 0
Synopsis stddoclet: Creates invalid stylesheet.css file (font-size: normal)
Category doclet:tbd
Reported Against 1.4 , 1.4.0_00 , ladybird-beta
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 3-Medium
Related Bugs 4737182 , 4826032
Submit Date 20-FEB-2001
Description

java version "1.3.1-beta"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1-beta-b15)
Java HotSpot(TM) Client VM (build 1.3.1beta-b15, mixed mode)

Java Source Code (Empty.java):
public class Empty { }

Steps to Reproduce:
javadoc Empty

The generated stylesheet.css file contains the lines:
.FrameTitleFont   { font-size: normal; font-family: normal }
.FrameHeadingFont { font-size: normal; font-family: normal }
.FrameItemFont    { font-size: normal; font-family: normal }

These lines generate the following errors when run through the W3C CSS
validator (http://jigsaw.w3.org/css-validator/):
Line: 14 Context : .FrameTitleFont Invalid number : font-size
normal is not a font-size value : normal
Line: 15 Context : .FrameHeadingFont Invalid number : font-size
normal is not a font-size value : normal
Line: 16 Context : .FrameItemFont Invalid number : font-size
normal is not a font-size value : normal
(Review ID: 117336) 
======================================================================
Another submitter:

    http://java.sun.com/j2se/1.3/docs/api/stylesheet.css  references
    font-family: normal in several styles.  This is not correct per 
    w3c spec since normal is not a keyword.  

    I recently added fonts to my system including one named
    "normal" which this stylesheet causes to be used in the javadoc
    left-hand frames.  It is a large and whimsically styled font family
    which is quite annoying in this context.
    Perhaps this should have been
    font-style: normal
    instead.  But in any case please leave off the 
    font-family specification to allow it to default instead of 
    specifying "normal".
    
       xxxxx@xxxxx  
Work Around




Manually edit the stylesheet.css file each time javadoc is run, and specify the
value "medium" for the font-size property.
======================================================================
Evaluation
It appears from the workaround that this person is asking us to change 
"normal" to "medium".  However, in Netscape on Solaris, this changes the
fonts in the left-hand frame from serif (Times) to sans-serif (Courier).
In this example, the default font in Preferences is Times.
So this is not an acceptable fix.  I'll write to ask him what he suggests.
  xxxxx@xxxxx   2001-02-22

His suggestion is to omit the font-size, since neither normal nor medium
work (would "default" work?), and to change font-family to serif.
Details under "Comment".  My suggested fix is under "Suggested Fix".
  xxxxx@xxxxx   2001-02-23

Assigning to Jamie to implement.  The final file should look like the
attached file stylesheet.css
  xxxxx@xxxxx   2001-03-28

This bug has been fixed in 1.4.0.  The final file now looks like the attached file.  Location of fix:

StylesheetWriter.java

  xxxxx@xxxxx   2001-05-29

I have to reopen this bug because it was not fixed properly.  The new lines in the stylesheet should be commented out (as mentioned in the suggested fix).  Also, pts should be pt in the stylesheet.
  xxxxx@xxxxx   2001-10-26

In addition to the two bugs mentioned above, the word "sans-serif" is
newly misspelled.  It is misspelled "san-serif".  

  .FrameTitleFont   { font-size: 10pts; font-family:
  Helvetica, Arial, san-serif }

Should read:

  .FrameTitleFont   { font-size: 10pt; font-family: 
  Helvetica, Arial, sans-serif }

  xxxxx@xxxxx   2002-07-08

The point of setting the font size is to make the font in the left-hand
frame smaller, so more characters of a long word are visible.  I suggest making
the font size relative, rather than just choose 10pt.  A value of 80% seems
good.

  xxxxx@xxxxx   2002-08-28

80% was too small for Internet Explorer, so I changed it to 90%
No regression test supplied, because the original problem was just a typo 
in the source.
  xxxxx@xxxxx   2002-09-11
Comments
  
  Include a link with my name & email   

Submitted On 02-JUL-2002
cpell
In 1.4.0, the same lines in stylesheet.css are now invalid
for new reasons:  the size is "10pts" instead of "10pt" (why
is it being forced to 10 points?), and the last of the
fallback font families is "san-serif" instead of
"sans-serif".  (Why bother forcing the font family at all?)



PLEASE NOTE: JDK6 is formerly known as Project Mustang