summaryrefslogtreecommitdiff
path: root/documentation/src/forms.dox
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2025-07-02 16:16:48 +0200
committerAlbrecht Schlosser <albrechts.fltk@online.de>2025-07-02 17:19:52 +0200
commita05ae33e20b09ab952ddbbf6762d5cfec77e4943 (patch)
treed56c63638917b24e3a35b7ca21dfbbe589c6f234 /documentation/src/forms.dox
parent9a5bdf40a475519ff7b80a9cc51452966e8325e2 (diff)
Remove deprecated methods and functions
In FLTK 1.5 we remove most (but not all) methods and functions that were deprecated in FLTK 1.3 or earlier.
Diffstat (limited to 'documentation/src/forms.dox')
-rw-r--r--documentation/src/forms.dox28
1 files changed, 13 insertions, 15 deletions
diff --git a/documentation/src/forms.dox b/documentation/src/forms.dox
index 816da55e6..545dd3af9 100644
--- a/documentation/src/forms.dox
+++ b/documentation/src/forms.dox
@@ -7,22 +7,21 @@ This appendix describes the Forms compatibility included with FLTK.
\note The Forms compatibility library is deprecated, no longer actively
maintained since FLTK 1.3.0, and likely to be removed completely
- in FLTK 1.5.
+ in FLTK 1.6. Building it was optional (ON) in FLTK 1.4.
-Since FLTK 1.4 building the Forms compatibility library \c fltk_forms
-(configure/Makefiles) or \c fltk::forms (CMake) can be disabled with
-one of these commands:
+Since FLTK 1.5 building the Forms compatibility library \c fltk_forms
+(aka \c fltk::forms) is disabled by default and can be enabled by one
+of the following commands:
\code
- - ./configure --disable-forms ...
- - cmake -D FLTK_BUILD_FORMS:BOOL=OFF ...
- - cmake-gui ...
+ - cmake -D FLTK_BUILD_FORMS:BOOL=ON ...
+ - cmake-gui ... (edit option FLTK_BUILD_FORMS)
\endcode
-Fluid can still import Forms and XForms designer (.fd) files but w/o
+Fluid can still \b import Forms and XForms designer (.fd) files but w/o
any guarantees for working results. Manual fixes may be necessary.
-In the next minor or major release (1.5 or higher) the Forms compatibility
-library will not be built by default or will be removed entirely.
+In the next minor or major release (1.6 or higher) the Forms compatibility
+library may be removed entirely.
\section forms_importing Importing Forms Layout Files
@@ -48,15 +47,14 @@ Take a look at <FL/forms.H> to see how it works, but the basic trick
is lots of inline functions. Most of the XForms demo programs work
without changes.
-You will also have to compile your Forms or XForms program using a
-C++ compiler. The FLTK library does not provide C bindings or header
-files.
+You will also have to compile your Forms or XForms program using a C++
+compiler. The FLTK library does not provide C bindings or header files.
Although FLTK was designed to be compatible with the GL Forms
library (version 0.3 or so), XForms has bloated severely and its
interface is X-specific. Therefore, XForms compatibility is no longer
-a goal of FLTK. Compatibility was limited to things that were free, or
-that would add code that would not be linked in if the feature is
+a goal of FLTK. Compatibility was limited to things that were free,
+or that would add code that would not be linked in if the feature is
unused, or that was not X-specific.
To use any new features of FLTK, you should rewrite your code to not