From 1761523c9e730ca7ac635be91d4e56d7ff77beab Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Sun, 1 Nov 2020 09:26:29 +0100
Subject: Add
 Fl_PostScript_File_Device::close_command(Fl_PostScript_Close_Command cmd)

Also expand Doxygen doc of class Fl_Printer for the X11 platform.
---
 FL/Fl_Printer.H | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

(limited to 'FL/Fl_Printer.H')

diff --git a/FL/Fl_Printer.H b/FL/Fl_Printer.H
index 784fcb806..e2b406ac4 100644
--- a/FL/Fl_Printer.H
+++ b/FL/Fl_Printer.H
@@ -59,15 +59,19 @@
  \endcode
  <b>Platform specifics</b>
  <ul>
- <li>Unix/Linux platforms:
+ <li>X11 platforms:
  <ul><li>FLTK expresses all graphics data using (Level 2) PostScript and sends that to the selected printer.
- See class Fl_PostScript_File_Device for a description of how text appears in print.
+ See class Fl_PostScript_File_Device for a description of how text and transparent images appear in print.
+ <li>If the GTK library is available at run-time, class Fl_Print runs GTK's printer dialog which allows to set
+ printer, paper size and orientation.
+ <li>If that library is not avaialble, or if Fl::option(Fl::OPTION_PRINTER_USES_GTK) has been turned off,
+ class Fl_Print runs FLTK's print dialog.
+ <ul>
  <li>Unless it has been previously changed, the default paper size is A4.
  To change that, press the "Properties" button of the "Print" dialog window
  opened by an Fl_Printer::begin_job() call. This opens a "Printer Properties" window where it's
  possible to select the adequate paper size. Finally press the "Save" button therein to assign
  the chosen paper size to the chosen printer for this and all further print operations.
- <li>Class Fl_RGB_Image prints but loses its transparency if it has one.
  <li>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
@@ -77,6 +81,7 @@
  <li>Use Fl_PostScript_File_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.
  </ul>
+ </ul>
  <li>Windows platform: Transparent Fl_RGB_Image 's don't print with exact transparency on most printers
  (a workaround is to use print_window_part() ).
  Fl_RGB_Image 's don't rotate() well.
-- 
cgit v1.2.3