annotate readme @ 1160:924c8087a755

Attempt to use the subversion revision number as the sub version number.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Fri, 16 Sep 2011 06:39:56 +0000
parents 1e0cd8dafdfb
children d2f37fda40df
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.
1014
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
11 MDI does not work on GTK3 and is not implemented the same on Mac.
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
12 At this time we cannot recommend using MDI in new code,
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
13 but it will be supported for existing code on OS/2, Win and GTK2.
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
14 If support for MDI improves on GTK3/Mac this status may change.
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
15 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
16 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
17 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
18 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
19 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
20 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
21 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
22 The workaround is to disable optimization or use clang instead.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
23
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
24 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
25
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
26 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
27 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
28
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
29 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
30 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
31 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
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 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
34 so environment variables DW_BORDER_WIDTH and DW_BORDER_HEIGHT
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
35 are used for proper positioning.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
36
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
37 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
38 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
39 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
40 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
41
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
42 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
43
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
44 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
45 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
46 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
47
1153
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
48 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
49 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
50 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
51 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
52 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
53 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
54 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
55 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
56 addition to dw_named_event_wait(), to block until the event is posted.
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.
f219ae018dd3 Updated readme with information from the 2.2 changes.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1111
diff changeset
60 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
61 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
62
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
63 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
64
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
65 http://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
66
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
67 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
68
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
69 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
70
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
71 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
72
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
73 Brian Smith