Mercurial > dwindows
annotate readme.txt @ 2991:81f9399b11c8
Mac/iOS: Fix exported API function definitions reported by Xcode.
Added missing APIs on functions, not necessary on Mac and iOS technically
but for consistence they should be there and for future use.
author | bsmith@81767d24-ef19-dc11-ae90-00e081727c95 |
---|---|
date | Tue, 04 Apr 2023 12:05:14 +0000 |
parents | ebb94fc2b19f |
children | c8bee3b6e7ce |
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 | 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 |
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. |
2297
48a541ffa84d
Some more information for the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2296
diff
changeset
|
76 |
1011
ea15fee48da8
Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
189
diff
changeset
|
77 Dynamic Windows Documentation is available at: |
3 | 78 |
2947
edb4307ac7ce
Update copyright date, readme, license and changelog for upcoming release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2910
diff
changeset
|
79 https://dbsoft.org/dw_help.php |
50
267b382442d6
Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
3
diff
changeset
|
80 |
1011
ea15fee48da8
Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
189
diff
changeset
|
81 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
|
82 |
ea15fee48da8
Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
189
diff
changeset
|
83 brian@dbsoft.org |
3 | 84 |
85 Thanks! | |
86 | |
87 Brian Smith |