Mercurial > dwindows
annotate readme.txt @ 2959:cde59690d3dd
C++: Step 1 of the std::string transition.
For all API calls that take UTF8 strings, create std::string versions.
We can't have the same functions that only differ in return type...
So we need to figure out what to do about those API calls.
Also need to decide if the class callback functions should be std::string.
Our connect versions can handle the conversions as necessary.
author | bsmith@81767d24-ef19-dc11-ae90-00e081727c95 |
---|---|
date | Tue, 14 Feb 2023 12:42:11 +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 | 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 |