JDK-4848456 : Javadoc for Toolkit.getPrintJob() in java.awt is incomplete
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.awt
  • Affected Version: 5.0
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2003-04-15
  • Updated: 2011-05-25
Related Reports
Relates :  
JDK-4844504 - PIT: printing application does not exit
Description

Name: dsR10078			Date: 04/15/2003



The documentation for Toolkit.getPrintJob() doesn't mention 
that this method can make the passed Frame displayable.
This causes confusion, see 4844504.
According to the "Requirements for Writing Java API Specifications" 
(see http://java.sun.com/j2se/javadoc/writingapispecs/index.html) 
the method specification must specify what state transitions 
this operation may trigger.

###@###.### 2003-04-15
======================================================================
Comments
WORK AROUND Name: dsR10078 Date: 04/15/2003 ======================================================================
11-06-2004
EVALUATION Accepted ###@###.### 2003-04-15 Name: dk30142 Date: 07/19/2003 Accepted ======================================================================
15-04-2003
SUGGESTED FIX Name: dsR10078 Date: 04/15/2003 --- Toolkit.java Tue Apr 15 12:58:50 2003 *************** *** 973,978 **** --- 973,981 ---- * that method is not overriden), then this results in a call to the * security manager's <code>checkPermission</code> method with a <code> * RuntimePermission("queuePrintJob")</code> permission. + * <p> + * This method can make the passed frame + * {@link Component#isDisplayable() displayable}. * * @param frame the parent of the print dialog. May not be null. * @param jobtitle the title of the PrintJob. A null title is equivalent ###@###.### 2003-04-15 ======================================================================
15-04-2003