annotate readme @ 1014:4493daea5886

Added important information about the status of MDI support to the readme. Also some other minor changes.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Mon, 16 May 2011 14:50:33 +0000
parents f0e012748633
children ce4121a6f657
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
1 This is a stable release of Dynamic Windows version 2.0.0.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
2
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
3 The current Dynamic Windows source base is stable on
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
4 OS/2, Windows, Linux, FreeBSD and Solaris. The Mac (Cocoa)
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
5 version appears stable but has not undergone harsh testing.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
6
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
7 Known problems:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
8
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
9 Boxes don't adhere to ratios on Unix.
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.
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
11 At this time we cannot recommend using MDI in new code,
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
12 but it will be supported for existing code on OS/2, Win and GTK2.
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
13 If support for MDI improves on GTK3/Mac this status may change.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
14
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
15 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
16
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
17 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
18 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
19
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
20 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
21 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
22 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
23
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
24 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
25 so environment variables DW_BORDER_WIDTH and DW_BORDER_HEIGHT
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
26 are used for proper positioning.
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
27
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
28 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
29 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
30 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
31 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
32
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
33 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
34
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
35 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
36 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
37 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
38
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
39 Changes from version 1.1:
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
40 Added support for MacOS 10.5 and higher Intel and PPC via Cocoa.
1014
4493daea5886 Added important information about the status of MDI support to the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1013
diff changeset
41 Added initial (unstable) support for GTK version 3.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
42 Added support for Windows themes on XP and higher.
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
43 Added scrollbox widgets, which function like boxes but...
1013
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
44 scrollbars allow you to pack more into them than the visible area.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
45 Added dw_window_get_font() for checking the font used on a widget.
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
46 Added dw_container_change_row_title() for changing a row pointer after insert.
1013
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
47 Added clipboard support on OS/2.
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
48 Added HICN data type for icon handles an changed icon functions to use it.
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
49 Added DW_RESOURCE() macro for casting to HICN when using resource IDs.
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
50 Added support for borderless buttons except on Windows (DW_BS_NOBORDER).
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
51 Changed the return codes of dw_container_setup, dw_filesystem_setup and
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
52 dw_event_wait(). Please check any code that use these functions.
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
53 Changed GTK2+ now supports font name styles like the other platforms.
1013
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
54 Enhanced transparent bitblt on OS/2 and Windows. OS/2 now supports
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
55 transparent color and Windows now supports 32bit alpha bitblt.
f0e012748633 Filled in more of the important changes form version 1.1 in the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1012
diff changeset
56 Removed thread limits on Windows and GTK using thread local storage.
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
57
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
58 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
59
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
60 http://dbsoft.org/help_functions.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
diff changeset
61
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
62 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
63
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
64 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
65
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
66 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
67
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
68 Brian Smith