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: 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
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang