diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2024-05-11 17:29:26 +0200 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2024-05-11 17:29:26 +0200 |
| commit | e9feef99fab53052b3c9a12c8e1911405a8de9e8 (patch) | |
| tree | 68d4abb1ef798bdbcef4b211754cb115a93acd73 | |
| parent | e5afb8a5328f2770028ac03f9100604ba69b62cb (diff) | |
Update README.CMake.txt for building X11 specific programs
Clarify different ways to disable Wayland in executable programs
designed to use X11 specific code w/o further changes.
| -rw-r--r-- | README.Wayland.txt | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/README.Wayland.txt b/README.Wayland.txt index f94c95986..f586d8075 100644 --- a/README.Wayland.txt +++ b/README.Wayland.txt @@ -70,25 +70,30 @@ FLTK source code and also X11-specific source code conceived for FLTK 1.3 should run with a Wayland-enabled FLTK 1.4 library with this single change. -Caveat: when building a user project with the requirement to use CMake -version 3.4 or higher, i.e. using +Note 1: this may require some linker flags to enable exporting symbols +from *executable* programs which FLTK uses to "read" the global symbol +'fl_disable_wayland'. For for GNU `ld` or any GNU compiler this would +be "-rdynamic". + + +Note 2: When building a user project with CMake 3.4 or higher, i.e. using cmake_minimum_required (VERSION 3.4) or any higher (minimum) CMake version users need to use at least one of -the following options: +the following techniques: Option 1: Set target property 'ENABLE_EXPORTS' on all executable - targets that require it to disable the Wayland backend. + targets that require to disable the Wayland backend. This is the preferred solution. CMake example: - set_target_properties(prog PROPERTIES ENABLE_EXPORTS TRUE) + set_target_properties(myprog PROPERTIES ENABLE_EXPORTS TRUE) Option 2: Set CMake policy CMP0065 to 'OLD' (to pre-3.4 behavior) This is a quick solution but discouraged because setting - CMake policies to 'OLD' is deprecated by definition. + CMake policies to 'OLD' is "deprecated by definition". CMake code: |
