changeset 2745:3245d79fa75f

Update the readme with new information about Windows, MacOS, iOS, Android and GTK4 ports, plus any important changes coming in 3.2 that were not already covered.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Mon, 20 Dec 2021 15:19:05 +0000
parents 608796a91527
children 0ce46809e95d
files readme.txt
diffstat 1 files changed, 23 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/readme.txt	Mon Dec 20 14:23:24 2021 +0000
+++ b/readme.txt	Mon Dec 20 15:19:05 2021 +0000
@@ -6,7 +6,7 @@
 
 Build Recommendations:
 MacOS:
-    11.0: configure --with-arch=modern --with-minver=10.14
+    11-12: configure --with-arch=modern --with-minver=10.14
         64bit Intel and Apple Silicon (ARM64) with Dark Mode.
     10.13-10.15: configure --with-minver=10.8
         64bit Intel with Notifications, Dark Mode for 10.14-15.
@@ -16,7 +16,7 @@
         32bit PowerPC, 64bit and 32bit Intel classic support.
         No Notifications, Dark Mode nor NSView container/trees.
 Windows:
-    7-10: Visual Studio 2017-2019, WebView2 and WinToast.
+    7-11: Visual Studio 2017-2022, WebView2 and WinToast.
         Should run on Vista and later, supports domain sockets
         on Windows 10, oldsockpipe() on older versions.
     XP: Visual Studio 2010.
@@ -30,7 +30,7 @@
 
 Boxes with no expandable items will have their contents centered on 
     GTK2 instead of top or left justified on the other platforms.
-GTK3 due to changes in the core architecture does not support
+GTK3/4 due to changes in the core architecture does not support
     widgets that are smaller than what is contained within them,
     unless they use scrolled windows. GTK2 and other platforms do.
     Therefore windows or other elements may expand their size to 
@@ -53,7 +53,6 @@
 OS/2 is also missing a notification system, so the new notification
 APIs are not yet supported on OS/2.  May implement our own system 
 if a popular notification system is not already in existance.
-Ports to iOS and Android are underway.
 
 Changes from version 3.1:
 Changed handling of button 3 press and release events.
@@ -91,6 +90,13 @@
 Added DW_FEATURE_WINDOW_PLACEMENT to test to see if we can get or
     set the positions of the windows on the screen.  Unavailable 
     on the following: iOS, Android, GTK3 or GTK4 with Wayland.
+Added DW_FEATURE_TREE to test to see if we can use the tree widget.
+    The tree widget is unsupported on: iOS and Android.
+Added DW_FEATURE_TASKBAR to test to see if we can use a taskbar icon.
+    The only platform that supports this feature on all supported
+    versions is Windows. OS/2 requires installed software, Mac
+    requires Yosemite and later.  GTK requires GTK2 or GTK3.
+    iOS and Android are unsupported.
 Added dw_render_redraw() function to trigger a DW_SIGNAL_EXPOSE 
     event on render widgets allowing drawing to happen in the
     callback. GTK4 and GTK3 with Wayland require drawing to be 
@@ -102,11 +108,20 @@
     don't always match the handles saved during window creation.
 Added support for dw_window_set_font() with a NULL font parameter.
     This resets the font used on the widget to the default font.
+Added a new constant DW_SIZE_AUTO to pass to box packing functions.
+Added a new constant DW_DIR_SEPARATOR which is char that defines
+    the path directory separator on the running platform.
+Changed the entrypoint to be dwmain() instead of main().
+    This allows special handling of the entrypoint on systems
+    requiring it such as: Windows, iOS and Android.
+    As such Windows ports no longer require winmain.c. 
 Changed dw_timer_connnect() and dw_timer_disconnect() to use HTIMER.
     This allows newer ports to use object handles that won't fit in
     what had been an integer reference.  OS/2 will use its native 
     HTIMER and other existing platforms will continue to use "int"
     for compatibility. Other platforms may change in the future.
+Changed dw_exec() with DW_EXEC_CON will now open the Terminal.app 
+    instead of attempting to launch an xterm on Mac.
 Fixed GTK warnings on GTK3 caused by using Pango style font syntax.
 Fixed GTK3 leaks when setting fonts or colors on a widget repeatedly.
 Fixed incorrect reporting of word wrap support on Windows.
@@ -120,6 +135,10 @@
     Windows 10 domain socket builds that work on earlier versions.
 Fixed building and several issues related to MacOS 10.5 now that I
     have a PowerMac G5 running 10.5.8 to test on.
+Fixed a bug in dw_listbox_set_text() on GTK3.
+Fixed sockpipe() functionality with gcc on OS/2.
+Ongoing work to have a more consistent code style across platforms.
+    See the accompanying style.txt file for more information.
 
 Dynamic Windows Documentation is available at: