annotate readme.txt @ 2257:9772a2306b43

Update the readme with in progress changes for version 3.2. Update the build recommendations after the sockpipe() changes for Windows.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Mon, 25 Jan 2021 22:09:49 +0000
parents 3e9c5bff0a57
children 176470d75695
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2257
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
1 This is a stable release of Dynamic Windows version 3.2.
3
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:
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
4 OS/2, Mac, Windows, Linux, FreeBSD and OpenSolaris.
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
5
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
6 Build Recommendations:
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
7 MacOS:
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
8 11.0: configure --with-arch=modern --with-minver=10.14
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
9 64bit Intel and Apple Silicon support with Dark Mode.
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
10 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
11 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
12 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
13 64 and 32bit Intel with Notifications but no Dark Mode.
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
14 10.6: configure --with-arch=classic --with-minver=10.5
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
15 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
16 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
17 Windows:
2257
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
18 7-10: Visual Studio 2017-2019, WebView2 and WinToast.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
19 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
20 on Windows 10, oldsockpipe() on older versions.
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
21 XP: Visual Studio 2010. Old sockpipe() on all versions.
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
22 Should run on XP and later, with Aero on Vista and 7.
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
23 No Notifications nor WebView2 and old sockpipe() 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
24 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
25 Should run on 2000 and later, no Aero, Notifications,
2220
4020bdb806dc Mac: Add --with-minver option for specifying the minimum MacOS version.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2216
diff changeset
26 WebView2 and old sockpipe() on all versions.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
27
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
28 Known problems:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
29
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
30 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
31 GTK2 instead of top or left justified on the other platforms.
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
32 GTK3 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
33 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
34 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
35 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
36 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
37 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
38 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
39 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
40 around oddly when passing over multibyte characters.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
41
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
42 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
43
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
44 It is not safe on all platforms to operate on widgets before they
1014
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
45 are packed. For portability pack widgets before operating on them.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
46
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
47 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
48
1350
4333b58d879d Upped the version number to 2.2. Added a Version file to reduce the number of places
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1340
diff changeset
49 OS/2 is currently missing the HTML widget because the system does
4333b58d879d Upped the version number to 2.2. Added a Version file to reduce the number of places
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1340
diff changeset
50 not support it by default. Looking into importing functionality
4333b58d879d Upped the version number to 2.2. Added a Version file to reduce the number of places
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1340
diff changeset
51 from available libraries (Firefox, Webkit, Qt, etc).
2228
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
52 OS/2 is also missing a notification system, so the new notification
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
53 APIs are not yet supported on OS/2. May implement our own system
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
54 if a popular notification system is not already in existance.
2407c8b46143 Update the readmes with new information and replace outdated links.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2221
diff changeset
55 Ports to iOS and Android are underway.
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
56
2257
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
57 Changes from version 3.1:
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
58 Added support for dw_window_set_font() with a NULL font paramaeter.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
59 This resets the font used on the widget to the default font.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
60 Fixed GTK warnings on GTK3 caused by using Pango style font syntax.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
61 Fixed GTK3 leaks when setting fonts or colors on a widget repeatedly.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
62 Fixed incorrect reporting of word wrap support on Windows.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
63 Fixed a number of misbehaviors with dw_window_set_font() and
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
64 dw_window_set_color() on various platforms.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
65 Added missing DW_CLR_DEFAULT support on OS/2, it previously only
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
66 worked to avoid setting a color, not resetting them to default.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
67 Added oldsockpipe() macro which will be used as a fallback.
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
68 This allows us to use domain socket sockpipe() when available...
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
69 and fall back to the old version when not, letting us have
9772a2306b43 Update the readme with in progress changes for version 3.2.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 2237
diff changeset
70 Windows 10 domain socket builds that work on earlier versions.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
71
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
72 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
73
1015
ce4121a6f657 Updated the readme with the new URL to the Dynamic Windows Web Help Index....
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1014
diff changeset
74 http://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
75
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
76 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
77
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
78 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
79
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
80 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
81
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
82 Brian Smith