From 9d869d73c1ca8f6c884f528a3ad4f623f25dffb1 Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Thu, 10 Mar 2022 15:05:26 +0100
Subject: Begin documenting the Wayland platform, new in FLTK version 1.4

---
 FL/Fl_PostScript.H |  4 ++--
 FL/Fl_Printer.H    | 11 +++++++----
 FL/wayland.H       |  3 +++
 3 files changed, 12 insertions(+), 6 deletions(-)

(limited to 'FL')

diff --git a/FL/Fl_PostScript.H b/FL/Fl_PostScript.H
index fbef51251..546145576 100644
--- a/FL/Fl_PostScript.H
+++ b/FL/Fl_PostScript.H
@@ -40,14 +40,14 @@ class Fl_PostScript_Graphics_Driver;
  This class is used exactly as the Fl_Printer class except for the begin_job() call,
  two variants of which are usable and allow to specify what page format and layout are desired.
 
- <b>Processing of text</b>: Text uses vectorial fonts under the X11 + pango platform.
+ <b>Processing of text</b>: Text uses vectorial fonts under the X11 + Pango and the Wayland platforms.
  With other platforms, only text restricted to the Latin alphabet (and a few other characters
  listed in the table below) and to FLTK standard fonts is vectorized.  All other unicode characters
  or all other fonts (FL_FREE_FONT and above) are output as a bitmap.
  FLTK standard fonts are output using the corresponding PostScript standard fonts.
  The latin alphabet means all unicode characters between U+0020 and U+017F, or, in other words,
  the ASCII, Latin-1 Supplement and Latin Extended-A charts.
- <br><b>Processing of transparent Fl_RGB_Image objects</b>: Under the X11 + pango platform,
+ <br><b>Processing of transparent Fl_RGB_Image objects</b>: Under the X11 + Pango and the Wayland platforms,
  these objects are output with their exact transparency. With other platforms, these objects
  are drawn blended to white color. Class Fl_EPS_File_Surface 's constructor allows to set another
  background color for blending.
diff --git a/FL/Fl_Printer.H b/FL/Fl_Printer.H
index e2b406ac4..a8e4fdce4 100644
--- a/FL/Fl_Printer.H
+++ b/FL/Fl_Printer.H
@@ -59,13 +59,16 @@
  \endcode
  <b>Platform specifics</b>
  <ul>
- <li>X11 platforms:
+ <li>X11 and Wayland 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 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
+ <li>If the GTK library is available at run-time, class Fl_Printer 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.
+ <li>Under the KDE desktop, Fl_Printer runs the <tt>kdialog</tt> command to create KDE-styled file dialogs if
+ that command is available at run-time, unless FLTK was built with CMake and option OPTION_USE_KDIALOG turned off.
+ In that case, Fl_Printer attempts to run the GTK dialog.
+ <li>If the GTK library is not available, or if Fl::option(Fl::OPTION_PRINTER_USES_GTK) has been turned off,
+ class Fl_Printer 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
diff --git a/FL/wayland.H b/FL/wayland.H
index af0851da7..626ac9e02 100755
--- a/FL/wayland.H
+++ b/FL/wayland.H
@@ -29,3 +29,6 @@ struct flWaylandRegion {
 
 #include <stdint.h>
 extern FL_EXPORT uint32_t fl_event_time;
+
+extern FL_EXPORT struct wl_surface *fl_wl_surface(Window xid);
+extern FL_EXPORT struct _cairo *fl_wl_cairo();
-- 
cgit v1.2.3