dwindows: readme.txt annotate

annotate readme.txt @ 2973:ac880987a2c4

Mac: Fix compiling with Xcode 8.2.1, needed #include <stdlib.h> and <errno.h> for missing alloca(), calloc() and errno.

author	bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date	Tue, 21 Mar 2023 00:41:25 +0000
parents	217ebbee034f
children	ebb94fc2b19f

rev	line source
2779 023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	1 This is a stable release of Dynamic Windows version 3.3.
3 67a643a734d9 Import 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:
2908 1567f787b965 C++: Add Notebook class and add named event support to the Event class. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2901 diff changeset	9 11-13: configure --with-arch=modern --with-minver=10.14
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.
2220 4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2216 diff changeset	25 2000: Visual Studio 2005. Remove -DAEROGLASS from CFLAGS.
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	26 Should run on 2000 and later, no Aero, Notifications,
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	27 WebView2 and oldsockpipe() 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 67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	39
67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	40 Known problems:
67a643a734d9 Import 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 67a643a734d9 Import 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
2779 023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	68 Changes from version 3.2:
2910 927fcf85b132 GTK4: Fix pageid type to be unsigned long in the macros. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2908 diff changeset	69 WARNING: Fixed an API inconsistency in dw_notebook_page_destroy/set().
927fcf85b132 GTK4: Fix pageid type to be unsigned long in the macros. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2908 diff changeset	70 The page ID had been unsigned int when it should be unsigned long.
927fcf85b132 GTK4: Fix pageid type to be unsigned long in the macros. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2908 diff changeset	71 On some platforms apps compiled for versions prior to 3.3 may
927fcf85b132 GTK4: Fix pageid type to be unsigned long in the macros. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2908 diff changeset	72 malfunction when calling these API calls, so recompile with 3.3.
2779 023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	73 Added tree widget/control support for iOS and Android.
023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	74 Removed the lib and dll directories previously used on Windows and OS/2.
023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	75 On Windows x86 and x64 subdirectories are created automatically
023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	76 This allows platform specific versions to be accessible without a
023045e14837 Bump version to 3.3, clear out the old release notes and put in the new. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2760 diff changeset	77 rebuild. Also removed the DWDLLDIR variable on Windows. If you have
2828 2c64d04abcf1 Update the readme with current information. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2779 diff changeset	78 DWLIBDIR pointing to the "lib" subdirectory please remove "\lib".
2c64d04abcf1 Update the readme with current information. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2779 diff changeset	79 Added DW_FEATURE_CONTAINER_MODE on Mobile platforms: iOS and Android.
2c64d04abcf1 Update the readme with current information. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2779 diff changeset	80 DW_CONTAINER_MODE_DEFAULT: Minimal container; icon and text only.
2c64d04abcf1 Update the readme with current information. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2779 diff changeset	81 DW_CONTAINER_MODE_EXTRA: Extra columns displayed on a second line.
2c64d04abcf1 Update the readme with current information. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2779 diff changeset	82 DW_CONTAINER_MODE_MULTI: A separate clickable line for each column.
2852 5018df4f952e Win/Android/Template: Add return values to dw_window_set_bitmap(_from_data). bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2828 diff changeset	83 Added return values to several functions previously returning void.
5018df4f952e Win/Android/Template: Add return values to dw_window_set_bitmap(_from_data). bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2828 diff changeset	84 Previous code should just be able to ignore the new return values.
5018df4f952e Win/Android/Template: Add return values to dw_window_set_bitmap(_from_data). bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2828 diff changeset	85 Currently affected: dw_window_set_bitmap(_from_data)
2875 d15517b49638 Update the mobile document with updated information for 3.3. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2852 diff changeset	86 Added C++ language bindings in dw.hpp and an example C++ test
d15517b49638 Update the mobile document with updated information for 3.3. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2852 diff changeset	87 application in the form of dwtestoo.cpp, similar to godwindows.
2901 761b7a12b079 Add va_list versions of dw_debug() and dw_messagebox() for use in C++ bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2875 diff changeset	88 Added variadic versions of dw_debug() and dw_messagebox().
761b7a12b079 Add va_list versions of dw_debug() and dw_messagebox() for use in C++ bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2875 diff changeset	89 This is how the standard library does it so we can call the new
761b7a12b079 Add va_list versions of dw_debug() and dw_messagebox() for use in C++ bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2875 diff changeset	90 va_list versions from C++: dw_vdebug() and dw_vmessagebox().
2950 0577a97fe36d Added dw_pixmap_get_width() and dw_pixmap_get_height() by request for language bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2949 diff changeset	91 Added dw_pixmap_get_height() and dw_pixmap_get_width() APIs to
0577a97fe36d Added dw_pixmap_get_width() and dw_pixmap_get_height() by request for language bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2949 diff changeset	92 replace the DW_PIXMAP_HEIGHT() and DW_PIXMAP_WIDTH() macros.
0577a97fe36d Added dw_pixmap_get_width() and dw_pixmap_get_height() by request for language bindings. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2949 diff changeset	93 This allows non-C bindings to call them directly.
2908 1567f787b965 C++: Add Notebook class and add named event support to the Event class. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2901 diff changeset	94 Added support for MacOS 13 Ventura and iOS 16.
2297 48a541ffa84d Some more information for the readme. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2296 diff changeset	95
1011 ea15fee48da8 Updates to the readme file for the upcoming 2.0 release. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 189 diff changeset	96 Dynamic Windows Documentation is available at:
3 67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	97
2947 edb4307ac7ce Update copyright date, readme, license and changelog for upcoming release. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 2910 diff changeset	98 https://dbsoft.org/dw_help.php
50 267b382442d6 Updated the readme. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 3 diff changeset	99
1011 ea15fee48da8 Updates to the readme file for the upcoming 2.0 release. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 189 diff changeset	100 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	101
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release. bsmith@81767d24-ef19-dc11-ae90-00e081727c95 parents: 189 diff changeset	102 brian@dbsoft.org
3 67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	103
67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	104 Thanks!
67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	105
67a643a734d9 Import ktk@81767d24-ef19-dc11-ae90-00e081727c95 parents: diff changeset	106 Brian Smith

Mercurial > dwindows

annotate readme.txt @ 2973:ac880987a2c4