annotate readme @ 1111:6782c2c722f4

Added information to the readme regarding potential issues upgrading to 2.1 on Windows and Lion.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Fri, 29 Jul 2011 21:50:27 +0000
parents 772d4c692ea5
children f219ae018dd3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1108
772d4c692ea5 Update readme and up version to 2.1 in the header in preparaton for release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1083
diff changeset
1 This is a stable release of Dynamic Windows version 2.1.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
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
9 GTK instead of top or left justified on the other platforms.
1014
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
10 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
11 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
12 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
13 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
14 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
15 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
16 unless they use scrolled windows. GTK2 and other platforms do.
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
17 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
18 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
19 The workaround is to disable optimization or use clang instead.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
20
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
21 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
22
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
23 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
24 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
25
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
26 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
27 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
28 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
29
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
30 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
31 so environment variables DW_BORDER_WIDTH and DW_BORDER_HEIGHT
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
32 are used for proper positioning.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
33
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
34 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
35 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
36 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
37 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
38
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
39 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
40
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
41 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
42 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
43 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
44
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
45 Changes from version 2.0:
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
46 Added support for MacOS 10.7 Lion, version 2.0 had some issues.
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
47 Changed the font point size on Windows to be system consistent.
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
48 Applications setting Windows fonts may need to be adjusted
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
49 after upgrading to version 2.1. This eliminates an old
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
50 workaround, but causes old fonts to potentially be wrong.
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
51 Fixed issues with the tree widget on Mac not being able to add
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
52 nodes at the same level with the same name.
1083
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
53 Added dw_font_set_default() to set the default text widget font.
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
54 Added dw_font_choose() to display a dialog to pick a font.
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
55 Added dw_box_pack_at_index() like the other dw_box_pack_*()
78d425edec46 Updates to the readme for version 2.1 (in progress).
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1043
diff changeset
56 functions except packing at arbitrary locations is possible.
1108
772d4c692ea5 Update readme and up version to 2.1 in the header in preparaton for release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1083
diff changeset
57 Added DW_INT_TO_POINTER/DW_POINTER_TO_INT/etc macros.
772d4c692ea5 Update readme and up version to 2.1 in the header in preparaton for release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1083
diff changeset
58 Fixed gcc warnings on 64bit systems and others.
772d4c692ea5 Update readme and up version to 2.1 in the header in preparaton for release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1083
diff changeset
59 Fixes for loading images from files on Windows and GTK3.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
60
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
61 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
62
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
63 http://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
64
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
65 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
66
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
67 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
68
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
69 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
70
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
71 Brian Smith