Mercurial > dwindows
annotate readme @ 1190:76262040ed5f
Added DW_PERCENT_INDETERMINATE which can be passed to dw_percent_set_pos() to
show a rotating or otherwise indeterminate percent bar on supported platforms.
Platforms which don't support it will either show no progress or potentially
growing and contracting progress in the future if that doesn't look too weird.
Committed from Windows so may be fixes coming for the other platforms soon.
author | bsmith@81767d24-ef19-dc11-ae90-00e081727c95 |
---|---|
date | Wed, 28 Sep 2011 08:22:48 +0000 |
parents | 1e0cd8dafdfb |
children | d2f37fda40df |
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 | 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 | 5 |
6 Known problems: | |
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 | 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 | 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 | 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 | 42 Future features: |
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 | 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 | 70 |
71 Thanks! | |
72 | |
73 Brian Smith |