Added platform-specific information to Fl_Printer doc.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7364 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 11 insertions, 6 deletions

diff --git a/FL/Fl_Printer.H b/FL/Fl_Printer.H
index f8dc9844c..bd2859638 100644
--- a/FL/Fl_Printer.H
+++ b/FL/Fl_Printer.H
@@ -52,19 +52,24 @@
  </ul>
  In both cases, begin by start_job(), start_page(), printable_rect() and origin() calls
  and finish by end_page() and end_job() calls.
- <p>On Xlib-based platforms (<i>e.g.</i>, Linux, Unix), this class is implemented as
+ <p><b>Platform specifics</b>
+ <ul>
+ <li>Xlib-based platforms (<i>e.g.</i>, Linux, Unix): this class is implemented as
  a subclass of Fl_PSfile_Device.
- <p>On Xlib-based platforms, the static public attributes of this class
- can be used to set the print dialog to other languages than English. For example, the "Printer:"
- dialog item Fl_Printer::dialog_printer can be set to French with:
+ Use the static public attributes of this class to set the print dialog to other languages 
+ than English. For example, the "Printer:" dialog item Fl_Printer::dialog_printer can be set to French with:
  \code
  Fl_Printer::dialog_printer = "Imprimante:";
  Fl_Printer myprinter;
  myprinter.start_job();
  \endcode
  Use Fl_PSfile_Device::file_chooser_title to customize the title of the file chooser dialog that opens
- when using the "Print To File" option of the print dialog.
- \see Fl_PSfile_Device.
+ when using the "Print To File" option of the print dialog. 
+ Class Fl_RGB_Image prints but looses its transparency if it has one.
+ <li>MSWindows platform: class Fl_RGB_Image looses its transparency if it has one, and doesn't rotate() well.
+ A workaround is to use the print_window_part() call. 
+ <li>Mac OS X platform: all graphics requests print as on display.
+ </ul>
  */
 class Fl_Printer : public Fl_Abstract_Printer {
 private: