|
Quick Lists
|
|
Bug ID:
|
4976567
|
|
Votes
|
0
|
|
Synopsis
|
DOC: API doc for lookupStreamPrintServiceFactories is misleading
|
|
Category
|
java:classes_2d
|
|
Reported Against
|
1.4
|
|
Release Fixed
|
7(b20)
|
|
State
|
10-Fix Delivered,
bug
|
|
Priority:
|
4-Low
|
|
Related Bugs
|
|
|
Submit Date
|
10-JAN-2004
|
|
Description
|
The API doc for StreamPrintServiceFactory.lookupStreamPrintServiceFactories(flavor, outputMimeType) says:
"Locates factories for print services that can be used with a print job to output a stream of data in the format specified by flavor. For example, the doc flavor is the document type that you want to create, not the flavor of the document before printing"
This is actually misleading. It's actually the MIMEType that determines the format of the output data and not the doc flavor. Flavor actually denotes the flavor of the input document such as JPG, PNG, Printable, Pageable etc and the mime type is the one which actually denotes the document format we want to create (say POSTSCRIPT).
This is noticed right from JDK1.4.
|
|
Work Around
|
N/A
|
|
Evaluation
|
The parameter spec is correct but the accompanying documentation is not
the easiest to read.
We should reword it to be clearer and correct the observed typo of saying
"doc flavor" when meaning "mime type".
Some of the other methods use the term "printers" when really the term
"print services" would be better, as there's no physical printer involved here.
Also I note that the link in the class description to the JAR file spec
on java.sun.com is no longer valid, presuably due to the recent reorganisation
of java.sun.com
xxxxx@xxxxx 2004-01-12
============================
|
|
Comments
|
PLEASE NOTE: JDK6 is formerly known as Project Mustang
|
|
|
 |