annotate readme @ 1050:48f43c975533

Added dw_font_choose() on the Mac for 2.1.
author bsmith@81767d24-ef19-dc11-ae90-00e081727c95
date Thu, 02 Jun 2011 05:23:45 +0000
parents 49a53cf864c1
children 78d425edec46
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
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
9 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
10 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
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.
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
15
64
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
16 Known limitations:
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
17
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
18 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
19 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
20
c2a10ed13d1f Added documentation of know platform limitations.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 50
diff changeset
21 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
22 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
23 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
24
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
25 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
26 so environment variables DW_BORDER_WIDTH and DW_BORDER_HEIGHT
189
230686a7eba9 Fixed typos.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 188
diff changeset
27 are used for proper positioning.
64
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 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
30 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
31 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
32 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
33
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
34 Future features:
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
35
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
36 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
37 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
38 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
39
1012
09c84a9aefe3 Added a basic changelog to the readme file from version 1.1.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 1011
diff changeset
40 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
41 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
42 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
43 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
44 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
45 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
46 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
47 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
48 Added clipboard support on OS/2.
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
49 Added HICN data type for icon handles and changed icon functions to use it.
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
50 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
51 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
52 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
53 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
54 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
55 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
56 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
57 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
58
1011
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
59 Dynamic Windows Documentation is available at:
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
60
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
61 http://dbsoft.org/dw_help.php
50
267b382442d6 Updated the readme.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 3
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 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
64
ea15fee48da8 Updates to the readme file for the upcoming 2.0 release.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents: 189
diff changeset
65 brian@dbsoft.org
3
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
66
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
67 Thanks!
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
68
ktk@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff changeset
69 Brian Smith