annotate readme.txt @ 3005:522ef24b0aba default tip

GTK4: Fix even more deprecation warnings in GTK 4.10 and later. Migrate to GtkAlertDialog for 4.10 from GtkMessageDialog. Still need to center the dialog or something.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Wed, 20 Dec 2023 05:17:54 +0000
parents 965fea56fc8e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2984
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
1 This is a stable release of Dynamic Windows version 3.4.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
2
1111
6782c2c722f4 Added information to the readme regarding potential issues upgrading to 2.1 on Windows and Lion.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1108
diff changeset
3 The current Dynamic Windows source base is considered stable on:
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
4 OS/2, Mac, Windows, Linux, FreeBSD, OpenSolaris and iOS.
2949
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
5 The source base is considered beta on Android, alpha on C++.
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
6
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
7 Build Recommendations:
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
8 MacOS:
2999
965fea56fc8e Mac: Add MacOS 14 Sonoma support... very few changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2993
diff changeset
9 11-13: configure --with-arch=modern --with-minver=10.15
2263
176470d75695 Remove the font test with Italic before Bold. This does not work on OS/2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2257
diff changeset
10 64bit Intel and Apple Silicon (ARM64) with Dark Mode.
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
11 10.13-10.15: configure --with-minver=10.8
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
12 64bit Intel with Notifications, Dark Mode for 10.14-15.
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
13 10.8-10.12: configure --with-arch=intel --with-minver=10.8
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
14 64 and 32bit Intel with Notifications but no Dark Mode.
2296
5dd3108db1a5 Update the readme with GTK4 and Mac information, plus a minor code cleanup.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2263
diff changeset
15 10.5-10.6: configure --with-arch=classic --with-minver=10.5
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
16 32bit PowerPC, 64bit and 32bit Intel classic support.
2221
9f336ce185fd Update Unix make rules for clean and dist taking into account 3.1 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2220
diff changeset
17 No Notifications, Dark Mode nor NSView container/trees.
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
18 Windows:
2745
3245d79fa75f Update the readme with new information about Windows, MacOS, iOS, Android
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2619
diff changeset
19 7-11: Visual Studio 2017-2022, WebView2 and WinToast.
2257
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
20 Should run on Vista and later, supports domain sockets
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
21 on Windows 10, oldsockpipe() on older versions.
2263
176470d75695 Remove the font test with Italic before Bold. This does not work on OS/2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2257
diff changeset
22 XP: Visual Studio 2010.
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
23 Should run on XP and later, with Aero on Vista and 7.
2263
176470d75695 Remove the font test with Italic before Bold. This does not work on OS/2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2257
diff changeset
24 No Notifications nor WebView2 and oldsockpipe() on all.
2992
c8bee3b6e7ce Bump up the internal version to 3.4 and update the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2984
diff changeset
25 2000: Visual Studio 2005. Should run on 2000 and later,
c8bee3b6e7ce Bump up the internal version to 3.4 and update the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2984
diff changeset
26 no Aero, no Notifications, no WebView2 and oldsockpipe()
c8bee3b6e7ce Bump up the internal version to 3.4 and update the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2984
diff changeset
27 on all versions.
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
28 C++: Recommends a C++11 compatible compiler.
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
29 MacOS: PowerPC GCC 6 from Tiger Brew.
2949
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
30 Intel Apple Clang from Xcode 4.4 or later.
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
31 Apple Silicon any supported Apple Clang.
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
32 Windows: Visual Studio 2015, recent Clang-cl or MingW32.
2957
217ebbee034f Win: Reenable -DAEROGLASS support, it was accidentally removed while testing on Win2k.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2950
diff changeset
33 Linux/FreeBSD: GCC 5 or Clang 3.3 recommended.
2949
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
34 OS/2: GCC 9.2 from Bitwise Works recommended.
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
35
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
36 If you build with a pre-C++11 compiler features will be
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
37 disabled, and you may ended up building an extremely
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
38 simplified sample application instead of the full one.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
39
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
40 Known problems:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
41
1043
49a53cf864c1 Fixed a typo and clarified one of the known issues which had been outdated
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1015
diff changeset
42 Boxes with no expandable items will have their contents centered on
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
43 GTK2 instead of top or left justified on the other platforms.
2949
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
44 Pack an expandable DW_NOHWND item at the end of the box to keep
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
45 the same appearance as other platforms.
2745
3245d79fa75f Update the readme with new information about Windows, MacOS, iOS, Android
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2619
diff changeset
46 GTK3/4 due to changes in the core architecture does not support
2228
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
47 widgets that are smaller than what is contained within them,
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
48 unless they use scrolled windows. GTK2 and other platforms do.
2228
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
49 Therefore windows or other elements may expand their size to
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
50 fit the contents, overriding requested size settings.
1768
227e13044ce3 Update readmes and up version to 2.4 in preparation for release
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1750
diff changeset
51 In Unicode mode on OS/2 there are some bugs in the input controls,
227e13044ce3 Update readmes and up version to 2.4 in preparation for release
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1750
diff changeset
52 minor bugs in entryfield based controls and major bugs in the MLE.
227e13044ce3 Update readmes and up version to 2.4 in preparation for release
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1750
diff changeset
53 The text displays properly but the cursor and selection jumps
227e13044ce3 Update readmes and up version to 2.4 in preparation for release
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1750
diff changeset
54 around oddly when passing over multibyte characters.
2828
2c64d04abcf1 Update the readme with current information.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2779
diff changeset
55 System scaling on Windows versions earlier than 10 will scale the
2c64d04abcf1 Update the readme with current information.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2779
diff changeset
56 individual controls, but will not scale the top-level window size.
2c64d04abcf1 Update the readme with current information.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2779
diff changeset
57 Windows 10 and higher will scale both the controls and window.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
58
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
59 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
60
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
61 Some widget may not be completely created when the widget handle is
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
62 returned. Some need to be setup such as Container controls on GTK,
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
63 and others need to be packed before they are finalized. Once setup
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
64 and packed it is completely safe to operate on widgets. If you choose
2949
a1d0522d7edf Update and fix the readme, had the wrong Xcode version and other issues.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2947
diff changeset
65 to operate on widgets before setup and/or packing, then it depends
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
66 on the platform if it will work or not.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
67
2984
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
68 Changes from version 3.3:
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
69 Pushed up the Android requirements to Android 8 (API 26 Oreo).
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
70 Added dw_html_javascript_add() and DW_SIGNAL_HTML_MESSAGE.
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
71 This allows HTML embedded javascript to call into native code.
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
72 Supported on Windows, Mac, GTK3/4, iOS and Android.
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
73 Windows 7+ with Edge WebView2. MacOS 10.10+.
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
74 GTK3/4 with WebKitGTK 2 or higher.
ebb94fc2b19f Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2957
diff changeset
75 iOS and Android, all supported versions.
2993
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
76 Added DW_FEATURE_RENDER_SAFE that requires safe rendering.
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
77 This means only allowing drawing in the EXPOSE callback.
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
78 On Android this also enables off main thread expose events.
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
79 Added high and low priority event queues on Android and
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
80 increased the queue length. This should prevent important
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
81 events from being dropped, only superfluous expose events.
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
82 This feature is enabled by default on Android.
392f0b3dd502 Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2992
diff changeset
83 This feature is disabled by default or unavailable on others.
2999
965fea56fc8e Mac: Add MacOS 14 Sonoma support... very few changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2993
diff changeset
84 Added support for MacOS 14 Sonoma and iOS 17.
2297
48a541ffa84d Some more information for the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2296
diff changeset
85
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
86 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
87
2947
edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2910
diff changeset
88 https://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
89
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
90 If you have any questions or suggestions feel free to email me at:
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
91
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
92 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
93
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
94 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
95
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
96 Brian Smith