summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlbrecht Schlosser <albrechts.fltk@online.de>2020-01-26 15:11:40 +0100
committerAlbrecht Schlosser <albrechts.fltk@online.de>2020-01-26 15:11:40 +0100
commitd2cb11369c8e6e846e16b88b327b871a498dac51 (patch)
tree946fd7f3d782739b3255cd5ebd819956a814448e
parent30a868dc0f9e777dfe3182920a04814d34538969 (diff)
Improve migration docs on Fl_Preferences
-rw-r--r--documentation/src/migration_1_4.dox15
1 files changed, 13 insertions, 2 deletions
diff --git a/documentation/src/migration_1_4.dox b/documentation/src/migration_1_4.dox
index 425135ca9..57fd9faea 100644
--- a/documentation/src/migration_1_4.dox
+++ b/documentation/src/migration_1_4.dox
@@ -5,7 +5,7 @@
This appendix describes the differences between the FLTK
1.3.x and FLTK 1.4.x functions and classes.
-\section migration_1_4_old_versions Migrating From FLTK 1.0 Or 1.1 To 1.4
+\section migration_1_4_old_versions Migrating from FLTK 1.0 or 1.1 to 1.4
If you want to migrate your code from FLTK 1.0 or 1.1 to FLTK 1.4,
then you should first consult the relevant appendices in FLTK 1.3
@@ -22,8 +22,19 @@ and/or https://www.fltk.org/software.php , respectively.
\section migration_1_4_preferences Fl_Preferences
-(to be documented)
+Starting with FLTK 1.3, preference databases are expected to be in UTF-8
+encoding. Previous databases were stored in the current character set or
+code page which renders them incompatible for text entries using
+international characters.
+
+Starting with FLTK 1.4, searching a valid path to store the preferences
+files has changed slightly. Please see
+Fl_Preferences::Fl_Preferences(Root, const char*, const char*)
+for details.
+If you want to retain user preferences you may want to move the preferences
+file from its old location to the new location as documented in
+Fl_Preferences::Fl_Preferences(Root, const char*, const char*) .
\htmlonly