Codebase list libdockapp / fa0ce3f
libdockapp: Merge ChangeLog into NEWS (they were largely the same). Doug Torrance authored 9 years ago Carlos R. Mafra committed 9 years ago
4 changed file(s) with 101 addition(s) and 170 deletion(s). Raw diff Collapse all Expand all
+0
-150
ChangeLog less more
0 This file is maintained by dtorrance@monmouthcollege.edu
1
2 Changelog for all libDockApp users.
3 ----------------------------------
4 This file contains a reverse chronology of changes.
5 The contents of this file will apply mostly to developers of dockapps.
6 Please read this when you update.
7
8 20140606
9 Release of libdockapp 0.6.3.
10 Updated autotools input files.
11 Added dockapp.pc file for use with pkg-config.
12
13 20050716:
14 Release of libDockapp 0.6.1.
15 Fixed parsing of multi-char short options.
16
17 20050522:
18 Release of libDockapp 0.6.0.
19
20 20050420:
21 Added DAError and DAWarning functions.
22
23 20050414:
24 Added DAFreeShapedPixmap.
25
26 20050408:
27 Added functions to read an XPM file dynamically.
28
29 Added a function to retrieve the program name from the program
30 arguments.
31
32 20030210:
33 Added a new global variable DAIcon. The value of this variable is
34 None if the dockapp runs in "windowed mode".
35
36 Added functions DAGetIconWindow() and
37 DASetIconWindow(Window icon_window). The "...Window"-part is because
38 X discerns between icon windows and icon pixmaps.
39
40 DAWindow now always points to the shown window. Normally this is the
41 icon window (DAIcon), but in "windowed mode" this is the leader window
42 (DALeader).
43
44 20030131:
45 Bumped the version of the library to 2.
46
47 20030130:
48 Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed
49 mode" will have a proper close-button now.
50
51 Child windows of a dockapp are now mapped as well when calling
52 DAShow().
53
54 Revamped the Changelog. Changedates have become important now that we
55 use them for backward compatibility.
56
57 20030126:
58 Added expected against actual version matching system. This has the
59 purpose of keeping the library backward compatible, even when the API
60 changes (as happened with DAGetDisplay).
61 Use the function DASetExpectedVersion(<changelog date>) in your dockapp
62 to ensure backward compatibility.
63
64 !!! COMPATIBILITY WARNING !!!
65 Renamed DAGetDisplay() to DAOpenDisplay(). The function opened a
66 display, this name makes more sense and there was a potential namespace
67 conflict (see below).
68
69 Added functions:
70 Display* DAGetDisplay(char *display, ...)
71 Window DAGetWindow()
72 Window DAGetLeader()
73 int DAGetDepth()
74 Visual* DAGetVisual()
75 DAGetDisplay(Display *display)
76 DAGetWindow(Window window)
77 DAGetLeader(Window leader)
78 DAGetDepth(int depth)
79 DAGetVisual(Visual *visual)
80 These functions just wrap the global variables DADisplay, DAWindow,
81 DALeader, DADepth and DAVisual. The globals are still available, and
82 will probably remain in future releases (The wrappers are for calls
83 from other dynamic objects).
84 If DASetExpectedVersion is before 20030126 (or not set), DAGetDisplay
85 will behave in the old way, opening the display instead of reading out
86 the variable. The NEW version of DAGetDisplay should be called as:
87 Display *d = DAGetDisplay(NULL);
88
89 20021220:
90 Added event handling for DestroyNotify, EnterWindow and LeaveWindow.
91
92 20021016:
93 Added a more complex example ("rectangles") showing the use of 'action
94 rectangles' and the handling of _all_ recognised event types; this one
95 may need some simplification.
96 Added an example ("shapes") of using the shaped pixmap API. No code
97 yet, just a directory.
98
99 20020926:
100 Added programming examples. There are three examples in the make: A
101 relatively simple example ("basic") without event handling and with
102 only basic shape implementation.
103
104 20020924:
105 Added a 7-segment display font. This font was donated by Jim Knoble.
106 Thanks Jim (It doesn't get installed, yet. I still need to make a
107 Makefile for this...).
108
109 20020922:
110 Added DAShapedPixmap type and functions to work with it. There is an
111 entire API around shaped pixmaps now, keeping pixmap, mask and geometry
112 together. It allows copying areas from both the pixmap and the mask to
113 another shaped pixmap, etc.
114
115 Added new global GC: DAClearGC. If you want to draw parts, you will
116 also want to erase parts.
117
118 20020921:
119 Added default colors as X-resources: DockApp*foreground and
120 DockApp*background. These colors are the foreground colors of DAGC and
121 DAClearGC respectively.
122
123 20020905:
124 "Inherited" the project from Pascal Hofstee. He stopped maintaining it,
125 and gave his okay when I asked to maintain it. We used to work on this
126 together, I'll continue the effort alone.
127
128 Release of libDockapp 0.4
129
130 Since libDockApp 0.2
131 --------------------
132 DockApps can now change shape on the fly.
133
134 Motion Events are properly handled now.
135
136 Code review/cleanup
137
138 Added DARect and DAActionRect structures. These allow You to easily
139 specify regions, and functions that should be called when clicked in
140 these regions.
141
142 DAEventLoop now finaly no longer causes Huge CPU-usage.
143
144 Turned out I had to disable the GCGraphicsExposures GC-Values, which
145 were generating huge amounts of "NoExpose" events which were simply
146 discarded anyway.
147
148 --
149 Before this, libdockapp was maintained and copyright by Alfredo Kojima.
+98
-17
NEWS less more
00 This file is maintained by dtorrance@monmouthcollege.edu, and available
11 from http://libdockapp.sourceforge.net
22
3
4 News for dockApp developers.
3 News for for all libDockApp users.
54 ----------------------------------
6 This file contains a reverse chronology of important additions and API-changes.
5 This file contains a reverse chronology of changes.
76 The contents of this file will apply mostly to developers of dockapps.
87 Please read this when you update.
98
4342 icon window (DAIcon), but in "windowed mode" this is the leader window
4443 (DALeader).
4544
45 20030131:
46 Bumped the version of the library to 2.
4647
4748 20030130:
48 Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in normal window
49 mode will have a proper close-button now.
49 Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed
50 mode" will have a proper close-button now.
5051
5152 Child windows of a dockapp are now mapped as well when calling
5253 DAShow().
5556 pixmaps by hand. This removes a lot of the complex parts of the
5657 example.
5758
59 Revamped the Changelog. Changedates have become important now that we
60 use them for backward compatibility.
5861
5962 20030126:
60 The function DAGetDisplay() has been renamed to DAOpenDisplay(). This
61 is unfortunate for backwards compatibility, but it was a bad name for
62 the function, and I needed the name for another function.
63 Added expected against actual version matching system. This has the
64 purpose of keeping the library backward compatible, even when the API
65 changes (as happened with DAGetDisplay).
66 Use the function DASetExpectedVersion(<changelog date>) in your dockapp
67 to ensure backward compatibility.
6368
64 New functions DAGetDisplay(), DAGetWindow(), DAGetLeader(),
65 DAGetDepth(), DAGetVisual(), and their Set... couterparts
66 (DASetDisplay(), etc) were added. These get and set the global
67 DA...-variables (see: dockapp.h), and are mainly for use from within
68 code that is not directly connected to the library (e.g. from within
69 another library).
69 !!! COMPATIBILITY WARNING !!!
70 Renamed DAGetDisplay() to DAOpenDisplay(). The function opened a
71 display, this name makes more sense and there was a potential namespace
72 conflict (see below).
7073
71 A system to match the expected version of libDockApp against the linked
72 version was added, to prevent backward compatibility problems in the
73 future.
74 Added functions:
75 Display* DAGetDisplay(char *display, ...)
76 Window DAGetWindow()
77 Window DAGetLeader()
78 int DAGetDepth()
79 Visual* DAGetVisual()
80 DAGetDisplay(Display *display)
81 DAGetWindow(Window window)
82 DAGetLeader(Window leader)
83 DAGetDepth(int depth)
84 DAGetVisual(Visual *visual)
85 These functions just wrap the global variables DADisplay, DAWindow,
86 DALeader, DADepth and DAVisual. The globals are still available, and
87 will probably remain in future releases (The wrappers are for calls
88 from other dynamic objects).
89 If DASetExpectedVersion is before 20030126 (or not set), DAGetDisplay
90 will behave in the old way, opening the display instead of reading out
91 the variable. The NEW version of DAGetDisplay should be called as:
92 Display *d = DAGetDisplay(NULL);
93
94 20021220:
95 Added event handling for DestroyNotify, EnterWindow and LeaveWindow.
96
97 20021016:
98 Added a more complex example ("rectangles") showing the use of 'action
99 rectangles' and the handling of _all_ recognised event types; this one
100 may need some simplification.
101 Added an example ("shapes") of using the shaped pixmap API. No code
102 yet, just a directory.
103
104 20020926:
105 Added programming examples. There are three examples in the make: A
106 relatively simple example ("basic") without event handling and with
107 only basic shape implementation.
108
109 20020924:
110 Added a 7-segment display font. This font was donated by Jim Knoble.
111 Thanks Jim (It doesn't get installed, yet. I still need to make a
112 Makefile for this...).
113
114 20020922:
115 Added DAShapedPixmap type and functions to work with it. There is an
116 entire API around shaped pixmaps now, keeping pixmap, mask and geometry
117 together. It allows copying areas from both the pixmap and the mask to
118 another shaped pixmap, etc.
119
120 Added new global GC: DAClearGC. If you want to draw parts, you will
121 also want to erase parts.
122
123 20020921:
124 Added default colors as X-resources: DockApp*foreground and
125 DockApp*background. These colors are the foreground colors of DAGC and
126 DAClearGC respectively.
127
128 20020905:
129 "Inherited" the project from Pascal Hofstee. He stopped maintaining it,
130 and gave his okay when I asked to maintain it. We used to work on this
131 together, I'll continue the effort alone.
132
133 Release of libDockapp 0.4
134
135 Since libDockApp 0.2
136 --------------------
137 DockApps can now change shape on the fly.
138
139 Motion Events are properly handled now.
140
141 Code review/cleanup
142
143 Added DARect and DAActionRect structures. These allow You to easily
144 specify regions, and functions that should be called when clicked in
145 these regions.
146
147 DAEventLoop now finaly no longer causes Huge CPU-usage.
148
149 Turned out I had to disable the GCGraphicsExposures GC-Values, which
150 were generating huge amounts of "NoExpose" events which were simply
151 discarded anyway.
152
153 --
154 Before this, libdockapp was maintained and copyright by Alfredo Kojima.
+2
-2
examples/basic/basic.c less more
5656 "use libDockapp.\n",
5757 "Basic example version 1.1");
5858
59 /* Tell libdockapp what version we expect it to be (a date from the
60 * ChangeLog should do).
59 /* Tell libdockapp what version we expect it to be (a date from
60 * NEWS should do).
6161 */
6262 DASetExpectedVersion(20020126);
6363
+1
-1
src/dockapp.h less more
142142 /*
143143 * Set the version of the library that the dockapp expects.
144144 * This is a date in the format 'yyyymmdd'. You can find this date
145 * in the ChangeLog.
145 * in NEWS.
146146 */
147147 void DASetExpectedVersion(unsigned long expectedVersion);
148148