Mercurial > dwindows
annotate readme.txt @ 2957:217ebbee034f
Win: Reenable -DAEROGLASS support, it was accidentally removed while testing on Win2k.
Also update the readme and recommended compiler message in dwtestoo.
Going to recommend GCC 5 since while 4.5+ should work it is extremely buggy.
author | bsmith@81767d24-ef19-dc11-ae90-00e081727c95 |
---|---|
date | Fri, 06 Jan 2023 19:55:55 +0000 |
parents | 0577a97fe36d |
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 | 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 | 39 |
40 Known problems: | |
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 | 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 | 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 | 103 |
104 Thanks! | |
105 | |
106 Brian Smith |