Javadoc for Toolkit.getPrintJob() in java.awt is incomplete

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
======================================================================