summaryrefslogtreecommitdiff
path: root/documentation/src/bundled-libs.dox
diff options
context:
space:
mode:
authorManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2025-09-08 12:49:41 +0200
committerManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2025-09-08 12:49:41 +0200
commitafc16b3331ca5656fd3fcde266e2c858327d6db3 (patch)
treecfd9467cd8ea6bb2b438a3e72f6ac6101810f007 /documentation/src/bundled-libs.dox
parentb69286f2ca93bdda135cff6189e22d01583c7624 (diff)
Remove from Doxygen files information about removed configure-based build system.
Diffstat (limited to 'documentation/src/bundled-libs.dox')
-rw-r--r--documentation/src/bundled-libs.dox48
1 files changed, 17 insertions, 31 deletions
diff --git a/documentation/src/bundled-libs.dox b/documentation/src/bundled-libs.dox
index 610203f7a..aa2a62fdd 100644
--- a/documentation/src/bundled-libs.dox
+++ b/documentation/src/bundled-libs.dox
@@ -109,8 +109,7 @@ Previous versions of bundled libraries (FLTK 1.3.x):
should be added in FLTK as well if they are necessary to build the
library. A simple "trial and error" should be sufficient to find files
that need to be added. Added files must be added to FLTK's build files
- as well, usually to both `Makefile' and `CMakeLists.txt' to be used in
- configure/make and in CMake based builds, respectively.
+ as well, usually `CMakeLists.txt', to be used in CMake based builds.
<h2>Upgrade order:</h2>
@@ -122,9 +121,9 @@ Previous versions of bundled libraries (FLTK 1.3.x):
<h2>Tests after merge:</h2>
- Tests should be done on as many platforms as possible, both with
- autotools (configure/make) and CMake. Windows (Visual Studio) and
- macOS (Xcode) builds need CMake to generate the IDE files.
+ Tests should be done on as many platforms as possible.
+ Windows (Visual Studio) and macOS (Xcode) builds need CMake to
+ generate the IDE files.
<h2>Upgrade notes for specific libraries:</h2>
@@ -162,18 +161,12 @@ Previous versions of bundled libraries (FLTK 1.3.x):
find out which changes are required. The general rule is to change
all occurrences of 'z_' to 'fltk_z_' but there *are* exceptions.
-
The following files need special handling:
- CMakeLists.txt: Keep FLTK version, update manually if necessary.
- - Makefile: Same as CMakeLists.txt.
- gzread.c: Merge changes (see above, manual merge recommended).
- zconf.h: Merge changes (see above, manual merge recommended).
- zlib.h: Merge changes (see above, manual merge recommended).
- - makedepend: Keep this file.
-
-Run `make depend' in the zlib folder on a Linux system after
- the upgrade to update this file.
\section bundled-png png:
@@ -195,13 +188,8 @@ Run `make depend' in the zlib folder on a Linux system after
The following files need special handling:
- CMakeLists.txt: Keep FLTK version, update manually if necessary.
- - Makefile: Same as CMakeLists.txt.
- pnglibconf.h: Generate on a Linux system and merge (see above).
- pngprefix.h: Generate on a Linux system and merge (see above).
- - makedepend: Keep this file.
-
-Run `make depend' in the png folder on a Linux system after
- the upgrade to update this file.
\section bundled-jpeg jpeg:
@@ -232,14 +220,9 @@ Run `make depend' in the png folder on a Linux system after
The following files need special handling:
- CMakeLists.txt: Keep FLTK version, update manually if necessary.
- - Makefile: Same as CMakeLists.txt.
- fltk_jpeg_prefix.h: Generate on a Linux system and merge (see above).
- jconfig.h: keep changes flagged with \verbatim /* FLTK */ \endverbatim
Note: more to come...
- - makedepend: Keep this file.
-
-Run `make depend' in the jpeg folder on a Linux system after
- the upgrade to update this file.
\section bundled-nanosvg nanosvg:
@@ -349,13 +332,16 @@ Run `make depend' in the jpeg folder on a Linux system after
\n Download: See website and follow links.
\n Repository: git clone https://gitlab.freedesktop.org/libdecor/libdecor.git
- libdecor is used by the Wayland/X11 hybrid platform to draw window
- titlebars when FLTK apps run as Wayland clients and the running
- Wayland compositor uses client-side decoration. In the future, when
- libdecor will have made its way into Linux packages, FLTK will use
- the system version of libdecor. libdecor will remain as an FLTK bundle to
- support Linux configurations where the libdecor package is not
- available or not installed.
+ The Wayland/X11 hybrid platform of FLTK uses a software component called
+ \e libdecor when FLTK apps run as Wayland clients. It allows FLTK to detect whether
+ the Wayland compositor in use requires client-side window decoration
+ and to decorate windows if it does.
+
+ In recent Linux distributions, FLTK is linked with the \e libdecor-0.so
+ system library installed from software package \e libdecor-0-dev.
+ FLTK bundles a copy of the libdecor source code to
+ support Linux/Unix configurations where the \e libdecor-0-dev package is not
+ available, not recent enough, or not installed.
FLTK uses libdecor source files without any modification.
This part of the libdecor source tree is copied to directory libdecor/ of
@@ -364,8 +350,8 @@ Run `make depend' in the jpeg folder on a Linux system after
LICENSE
README.md
src/ ... and files below except meson.build files
-</pre>
+ </pre>
Furthermore, directory libdecor/build/ of the FLTK source tree does not
- originate from the libdecor source tree but contains 3 FLTK-created files.
- File build/Makefile may need changes if a libdecor update adds or renames source files.
+ originate from the libdecor source tree but contains 4 FLTK-created files.
+ File src/CMakeLists.txt may need changes if a libdecor update adds or renames source files.
*/