wmclockmon: update change-log
[dockapps.git] / libdockapp / NEWS
blobecf67ea889faf64aec47ec4693c3f55379297ce7
1 This file is maintained by wmaker-dev@googlegroups.com, and available
2 from https://www.dockapps.net/libdockapp.
4 News for for all libDockApp users.
5 ----------------------------------
6 This file contains a reverse chronology of changes.
7 The contents of this file will apply mostly to developers of dockapps.
8 Please read this when you update.
10 20141128
11         Release of libdockapp 0.6.4.
12         Source code cleanup.
13         Now maintained by Window Maker Developers Team.
15 20140606
16         Release of libdockapp 0.6.3.
17         Updated autotools input files.
18         Added dockapp.pc file for use with pkg-config.
20 20050716:
21         Release of libdockapp 0.6.1
22         Fixed parsing multi-character short options.
24 20050522:
25         Release of libDockapp 0.6.0.
27 20050420:
28         Added DAError and DAWarning functions.
30 20050414:
31         Added DAFreeShapedPixmap.
33 20050408:
34         Added functions to read an XPM file dynamically.
36         Added a function to retrieve the program name from the program
37         arguments.
39 20030210:
40         Added a new global variable DAIcon. The value of this variable is
41         None if the dockapp runs in "windowed mode".
43         Added functions DAGetIconWindow() and
44         DASetIconWindow(Window icon_window). The "...Window"-part is because
45         X discerns between icon windows and icon pixmaps.
47         DAWindow now always points to the shown window. Normally this is the
48         icon window (DAIcon), but in "windowed mode" this is the leader window
49         (DALeader).
51 20030131:
52         Bumped the version of the library to 2.
54 20030130:
55         Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed
56         mode" will have a proper close-button now.
58         Child windows of a dockapp are now mapped as well when calling
59         DAShow().
61         Reworked basic example to use a Window instead of drawing and erasing
62         pixmaps by hand. This removes a lot of the complex parts of the
63         example.
65         Revamped the Changelog. Changedates have become important now that we
66         use them for backward compatibility.
68 20030126:
69         Added expected against actual version matching system. This has the
70         purpose of keeping the library backward compatible, even when the API
71         changes (as happened with DAGetDisplay).
72         Use the function DASetExpectedVersion(<changelog date>) in your dockapp
73         to ensure backward compatibility.
75     !!! COMPATIBILITY WARNING !!!
76         Renamed DAGetDisplay() to DAOpenDisplay(). The function opened a
77         display, this name makes more sense and there was a potential namespace
78         conflict (see below).
80         Added functions:
81                 Display*        DAGetDisplay(char *display, ...)
82                 Window          DAGetWindow()
83                 Window          DAGetLeader()
84                 int             DAGetDepth()
85                 Visual*         DAGetVisual()
86                 DAGetDisplay(Display *display)
87                 DAGetWindow(Window window)
88                 DAGetLeader(Window leader)
89                 DAGetDepth(int depth)
90                 DAGetVisual(Visual *visual)
91         These functions just wrap the global variables DADisplay, DAWindow,
92         DALeader, DADepth and DAVisual. The globals are still available, and
93         will probably remain in future releases (The wrappers are for calls
94         from other dynamic objects).
95         If DASetExpectedVersion is before 20030126 (or not set), DAGetDisplay
96         will behave in the old way, opening the display instead of reading out
97         the variable. The NEW version of DAGetDisplay should be called as:
98                 Display *d = DAGetDisplay(NULL);
100 20021220:
101         Added event handling for DestroyNotify, EnterWindow and LeaveWindow.
103 20021016:
104         Added a more complex example ("rectangles") showing the use of 'action
105         rectangles' and the handling of _all_ recognised event types; this one
106         may need some simplification.
107         Added an example ("shapes") of using the shaped pixmap API. No code
108         yet, just a directory.
110 20020926:
111         Added programming examples. There are three examples in the make: A
112         relatively simple example ("basic") without event handling and with
113         only basic shape implementation.
115 20020924:
116         Added a 7-segment display font. This font was donated by Jim Knoble.
117         Thanks Jim (It doesn't get installed, yet. I still need to make a
118         Makefile for this...).
120 20020922:
121         Added DAShapedPixmap type and functions to work with it. There is an
122         entire API around shaped pixmaps now, keeping pixmap, mask and geometry
123         together. It allows copying areas from both the pixmap and the mask to
124         another shaped pixmap, etc.
126         Added new global GC: DAClearGC. If you want to draw parts, you will
127         also want to erase parts.
129 20020921:
130         Added default colors as X-resources: DockApp*foreground and
131         DockApp*background. These colors are the foreground colors of DAGC and
132         DAClearGC respectively.
134 20020905:
135         "Inherited" the project from Pascal Hofstee. He stopped maintaining it,
136         and gave his okay when I asked to maintain it. We used to work on this
137         together, I'll continue the effort alone.
139         Release of libDockapp 0.4
141 Since libDockApp 0.2
142 --------------------
143         DockApps can now change shape on the fly.
145         Motion Events are properly handled now.
147         Code review/cleanup
149         Added DARect and DAActionRect structures. These allow You to easily
150         specify regions, and functions that should be called when clicked in
151         these regions.
153         DAEventLoop now finaly no longer causes Huge CPU-usage.
155         Turned out I had to disable the GCGraphicsExposures GC-Values, which
156         were generating huge amounts of "NoExpose" events which were simply
157         discarded anyway.
160 Before this, libdockapp was maintained and copyright by Alfredo Kojima.