libdockapp/NEWS

   1 This file is maintained by wmaker-dev@googlegroups.com, and available
   2 from https://www.dockapps.net/libdockapp.
   3
   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.
   9
  10 20141128
  11         Release of libdockapp 0.6.4.
  12         Source code cleanup.
  13         Now maintained by Window Maker Developers Team.
  14
  15 20140606
  16         Release of libdockapp 0.6.3.
  17         Updated autotools input files.
  18         Added dockapp.pc file for use with pkg-config.
  19
  20 20050716:
  21         Release of libdockapp 0.6.1
  22         Fixed parsing multi-character short options.
  23
  24 20050522:
  25         Release of libDockapp 0.6.0.
  26
  27 20050420:
  28         Added DAError and DAWarning functions.
  29
  30 20050414:
  31         Added DAFreeShapedPixmap.
  32
  33 20050408:
  34         Added functions to read an XPM file dynamically.
  35
  36         Added a function to retrieve the program name from the program
  37         arguments.
  38
  39 20030210:
  40         Added a new global variable DAIcon. The value of this variable is
  41         None if the dockapp runs in "windowed mode".
  42
  43         Added functions DAGetIconWindow() and
  44         DASetIconWindow(Window icon_window). The "...Window"-part is because
  45         X discerns between icon windows and icon pixmaps.
  46
  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).
  50
  51 20030131:
  52         Bumped the version of the library to 2.
  53
  54 20030130:
  55         Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed
  56         mode" will have a proper close-button now.
  57
  58         Child windows of a dockapp are now mapped as well when calling
  59         DAShow().
  60
  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.
  64
  65         Revamped the Changelog. Changedates have become important now that we
  66         use them for backward compatibility.
  67
  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.
  74
  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).
  79
  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);
  99
 100 20021220:
 101         Added event handling for DestroyNotify, EnterWindow and LeaveWindow.
 102
 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.
 109
 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.
 114
 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...).
 119
 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.
 125
 126         Added new global GC: DAClearGC. If you want to draw parts, you will
 127         also want to erase parts.
 128
 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.
 133
 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.
 138
 139         Release of libDockapp 0.4
 140
 141 Since libDockApp 0.2
 142 --------------------
 143         DockApps can now change shape on the fly.
 144
 145         Motion Events are properly handled now.
 146
 147         Code review/cleanup
 148
 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.
 152
 153         DAEventLoop now finaly no longer causes Huge CPU-usage.
 154
 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.
 158
 159 --
 160 Before this, libdockapp was maintained and copyright by Alfredo Kojima.