annotate readme @ 1194:d2f37fda40df

Updated the readme file with the latest changes.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Wed, 28 Sep 2011 15:03:50 +0000
parents 1e0cd8dafdfb
children 452a5b1b2aa5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
1 This is a preview release of Dynamic Windows version 2.2.0.
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:
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
4 OS/2, Mac, Windows, Linux, FreeBSD and Solaris.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
5
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
6 Known problems:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
7
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
8 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
9 GTK2 instead of top or left justified on the other platforms.
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
10 This has been rectified in the GTK3 version via GtkGrid.
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
11 GTK3 due to changes in the core architecture does not support
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
12 widgets that are smaller than what is contained within them
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
13 unless they use scrolled windows. GTK2 and other platforms do.
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
14 GTK 3.0 is not fully supported due to missing GtkGrid functions and
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
15 severe layout bugs that can't be worked around. Use 3.1 or higher.
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
16 Mac version built on Lion with Xcode 4.1 in 64bit mode will encounter
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
17 a compiler optimization problem with the default gcc compiler.
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
18 The workaround is to disable optimization or use clang instead.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
19
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
20 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
21
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
22 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
23 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
24
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
25 On Windows a slider control will only work properly if it is the
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
26 only slider in a box. If there is more than one slider control
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
27 in a box then signals may get misdirected to the wrong control.
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
28
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
29 On Unix (GTK) the window manager border is not a constant value
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
30 so environment variables DW_BORDER_WIDTH and DW_BORDER_HEIGHT
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
31 are used for proper positioning.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
32
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
33 On Mac if performing Dynamic Windows operations on secondary
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
34 threads which do not terminate, it may be required to call
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
35 a Mac specific DW function _dw_pool_drain() at the end of the
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
36 thread's loop to prevent memory leaks.
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
37
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
38 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
39
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
40 OS/2 is currently missing the Calendar and HTML widgets because
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
41 the system does not support them by default. Looking into writing
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
42 custom ones or importing functionality from available libraries.
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
43
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
44 Changes from version 2.1:
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
45 Added printing support via dw_print_new, dw_print_run and dw_print_cancel.
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
46 Added pixmap font override support. In prior versions when drawing
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
47 text to pixmaps the font set on the associated window handle is used.
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
48 dw_pixmap_set_font() can now override that font setting, and now
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
49 pixmaps without associated windows are supported and used in printing.
1159
1e0cd8dafdfb Added more change information to the readme file.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1153
diff changeset
50 Added dw_mutex_trylock() function to try to obtain a mutex without blocking.
1e0cd8dafdfb Added more change information to the readme file.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1153
diff changeset
51 Added DW_TIMEOUT_INFINITE which can now be used with dw_event_wait() in
1e0cd8dafdfb Added more change information to the readme file.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1153
diff changeset
52 addition to dw_named_event_wait(), to block until the event is posted.
1194
d2f37fda40df Updated the readme file with the latest changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1159
diff changeset
53 Added DW_PERCENT_INDETERMINATE which can be passed to dw_percent_set_pos().
d2f37fda40df Updated the readme file with the latest changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1159
diff changeset
54 This should work on all platforms except old versions of Windows and OS/2.
d2f37fda40df Updated the readme file with the latest changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1159
diff changeset
55 Added the subversion revision number as the third Dynamic Windows version
d2f37fda40df Updated the readme file with the latest changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1159
diff changeset
56 number when building from a subversion source tree.
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
57 Improved container optimization on Mac, header width now taken into account.
1159
1e0cd8dafdfb Added more change information to the readme file.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1153
diff changeset
58 Fixes for incorrect return codes from the dw_event_* functions on Windows.
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
59 Fixes for incorrect behavior on key_press callbacks on Mac and Windows.
1194
d2f37fda40df Updated the readme file with the latest changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1159
diff changeset
60 Fixes for MDI support in GTK3.
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
61 Fixes for lots of GTK3 layout and window positioning issues...
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
62 although minimum size issues are still present.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
63
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
64 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
65
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
66 http://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
67
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
68 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
69
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
70 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
71
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
72 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
73
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
74 Brian Smith