4d55983833
The goal is to change the version number for a new release only in CMakeLists.txt. This is the second step. This commit also adds a chapter "Migrating Code from FLTK 1.4 to 1.5". Details: - documentation/CMakeLists.txt: configure 'version.dox' - fluid/documentation/CMakeLists.txt: same as above - documentation/Doxyfile.in: add "Migrating Code from FLTK 1.4 to 1.5" - documentation/src/index.dox: include 'version.dox' and 'migrating...' - fluid/documentation/src/index.dox: same as above - documentation/src/preface.dox: include 'version.dox' - documentation/version.dox.in: input to CMake configure 'version.dox' - fluid/documentation/version.dox.in: same as above - documentation/src/migration_1_4.dox: update links - documentation/src/migration_1_5.dox: new documentation chapter
104 lines
3.3 KiB
Plaintext
104 lines
3.3 KiB
Plaintext
/**
|
|
|
|
\page migration_1_5 Migrating Code from FLTK 1.4 to 1.5
|
|
|
|
This appendix describes the differences between FLTK
|
|
1.4.x and FLTK 1.5.x functions and classes and potential requirements
|
|
to change source code. We also explain how code can be made compatible
|
|
so it can be compiled by FLTK 1.3.x, 1.4.x, and 1.5.x.
|
|
|
|
If you need to migrate your code from prior FLTK versions to FLTK 1.4,
|
|
please consult the relevant appendices in the FLTK 1.3 online documentation
|
|
or by downloading the FLTK 1.3 documentation.
|
|
See https://www.fltk.org/doc-1.3/migration_1_3.html and/or
|
|
https://www.fltk.org/software.php, respectively.
|
|
|
|
|
|
\section migration_1_5_cmake CMake is required to build FLTK
|
|
|
|
Building with configure/make and included Makefile's has been discontinued.
|
|
Since FLTK 1.5.0 CMake is required to build FLTK. Please see README.CMake.txt
|
|
for details.
|
|
|
|
|
|
\section migration_1_5_cxx_standard FLTK requires C++11 or higher
|
|
|
|
You need a compiler or build system capable of at least C++ standard C++11.
|
|
The compiler must be configured to run in C++11 mode or higher.
|
|
|
|
FLTK sets the required compiler options automatically (via CMake) for its own
|
|
build.
|
|
|
|
If you use "Modern CMake" (basically CMake in CONFIGURE mode) to build your
|
|
own projects the appropriate options are inherited from the properties of
|
|
the FLTK libraries as well. Otherwise you may need to set the compiler flags
|
|
to use at least C++11 yourself.
|
|
|
|
|
|
\section migration_1_5_forms Default for FORMS compatibility is now OFF
|
|
|
|
If you need (X)Forms compatibility you must set the CMake configure option
|
|
|
|
FLTK_BUILD_FORMS:BOOL=ON
|
|
|
|
manually. In previous versions (up to 1.4.x) the default was 'ON', but since
|
|
Forms compatibility is not a primary goal of FLTK this is now optional.
|
|
|
|
|
|
(X)Forms support \b may be removed entirely in a future FLTK release. We
|
|
recommend all users to rewrite their code to use "native" FLTK code anyway.
|
|
|
|
|
|
|
|
\section migration_1_5_fl_override Simplified FL_OVERRIDE Macro
|
|
|
|
FLTK 1.4 defined a new macro \p FL_OVERRIDE as "override" if (and only if)
|
|
a recent C++ standard (C++11 or higher) was used to compile its code.
|
|
|
|
Since FLTK 1.5 this macro is unconditionally defined as 'override' because
|
|
FLTK requires C++11 anyway.
|
|
|
|
For more details please see \ref migration_1_4_fl_override.
|
|
|
|
|
|
\section migration_1_5_deprecated Deprecated methods and functions removed
|
|
|
|
Methods, functions, and global symbols that have been deprecated in FLTK 1.3
|
|
or earlier have been removed. If you need help with those functions because
|
|
your old code still uses one or more of them, please consult the FLTK 1.3 or
|
|
1.4 documentation for how to replace them with newer functions/methods.
|
|
|
|
The following (very likely incomplete) list may help to identify such removed
|
|
methods and functions:
|
|
|
|
Removed symbol | Replace with ...
|
|
--------------------------|-------------------------
|
|
Fl::release() | Fl::grab(0)
|
|
|
|
|
|
|
|
\htmlonly
|
|
<hr>
|
|
<table summary="navigation bar" width="100%" border="0">
|
|
<tr>
|
|
<td width="45%" align="LEFT">
|
|
<a class="el" href="migration_1_4.html">
|
|
[Prev]
|
|
Migrating Code from FLTK 1.3 to 1.4
|
|
</a>
|
|
</td>
|
|
<td width="10%" align="CENTER">
|
|
<a class="el" href="index.html">[Index]</a>
|
|
</td>
|
|
<td width="45%" align="RIGHT">
|
|
<a class="el" href="license.html">
|
|
Software License
|
|
[Next]
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
\endhtmlonly
|
|
|
|
*/
|