diff --git a/libdockapp/ChangeLog b/libdockapp/ChangeLog deleted file mode 100644 index 5c5c202..0000000 --- a/libdockapp/ChangeLog +++ /dev/null @@ -1,150 +0,0 @@ -This file is maintained by dtorrance@monmouthcollege.edu - -Changelog for all libDockApp users. ----------------------------------- -This file contains a reverse chronology of changes. -The contents of this file will apply mostly to developers of dockapps. -Please read this when you update. - -20140606 - Release of libdockapp 0.6.3. - Updated autotools input files. - Added dockapp.pc file for use with pkg-config. - -20050716: - Release of libDockapp 0.6.1. - Fixed parsing of multi-char short options. - -20050522: - Release of libDockapp 0.6.0. - -20050420: - Added DAError and DAWarning functions. - -20050414: - Added DAFreeShapedPixmap. - -20050408: - Added functions to read an XPM file dynamically. - - Added a function to retrieve the program name from the program - arguments. - -20030210: - Added a new global variable DAIcon. The value of this variable is - None if the dockapp runs in "windowed mode". - - Added functions DAGetIconWindow() and - DASetIconWindow(Window icon_window). The "...Window"-part is because - X discerns between icon windows and icon pixmaps. - - DAWindow now always points to the shown window. Normally this is the - icon window (DAIcon), but in "windowed mode" this is the leader window - (DALeader). - -20030131: - Bumped the version of the library to 2. - -20030130: - Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed - mode" will have a proper close-button now. - - Child windows of a dockapp are now mapped as well when calling - DAShow(). - - Revamped the Changelog. Changedates have become important now that we - use them for backward compatibility. - -20030126: - Added expected against actual version matching system. This has the - purpose of keeping the library backward compatible, even when the API - changes (as happened with DAGetDisplay). - Use the function DASetExpectedVersion() in your dockapp - to ensure backward compatibility. - - !!! COMPATIBILITY WARNING !!! - Renamed DAGetDisplay() to DAOpenDisplay(). The function opened a - display, this name makes more sense and there was a potential namespace - conflict (see below). - - Added functions: - Display* DAGetDisplay(char *display, ...) - Window DAGetWindow() - Window DAGetLeader() - int DAGetDepth() - Visual* DAGetVisual() - DAGetDisplay(Display *display) - DAGetWindow(Window window) - DAGetLeader(Window leader) - DAGetDepth(int depth) - DAGetVisual(Visual *visual) - These functions just wrap the global variables DADisplay, DAWindow, - DALeader, DADepth and DAVisual. The globals are still available, and - will probably remain in future releases (The wrappers are for calls - from other dynamic objects). - If DASetExpectedVersion is before 20030126 (or not set), DAGetDisplay - will behave in the old way, opening the display instead of reading out - the variable. The NEW version of DAGetDisplay should be called as: - Display *d = DAGetDisplay(NULL); - -20021220: - Added event handling for DestroyNotify, EnterWindow and LeaveWindow. - -20021016: - Added a more complex example ("rectangles") showing the use of 'action - rectangles' and the handling of _all_ recognised event types; this one - may need some simplification. - Added an example ("shapes") of using the shaped pixmap API. No code - yet, just a directory. - -20020926: - Added programming examples. There are three examples in the make: A - relatively simple example ("basic") without event handling and with - only basic shape implementation. - -20020924: - Added a 7-segment display font. This font was donated by Jim Knoble. - Thanks Jim (It doesn't get installed, yet. I still need to make a - Makefile for this...). - -20020922: - Added DAShapedPixmap type and functions to work with it. There is an - entire API around shaped pixmaps now, keeping pixmap, mask and geometry - together. It allows copying areas from both the pixmap and the mask to - another shaped pixmap, etc. - - Added new global GC: DAClearGC. If you want to draw parts, you will - also want to erase parts. - -20020921: - Added default colors as X-resources: DockApp*foreground and - DockApp*background. These colors are the foreground colors of DAGC and - DAClearGC respectively. - -20020905: - "Inherited" the project from Pascal Hofstee. He stopped maintaining it, - and gave his okay when I asked to maintain it. We used to work on this - together, I'll continue the effort alone. - - Release of libDockapp 0.4 - -Since libDockApp 0.2 --------------------- - DockApps can now change shape on the fly. - - Motion Events are properly handled now. - - Code review/cleanup - - Added DARect and DAActionRect structures. These allow You to easily - specify regions, and functions that should be called when clicked in - these regions. - - DAEventLoop now finaly no longer causes Huge CPU-usage. - - Turned out I had to disable the GCGraphicsExposures GC-Values, which - were generating huge amounts of "NoExpose" events which were simply - discarded anyway. - --- -Before this, libdockapp was maintained and copyright by Alfredo Kojima. diff --git a/libdockapp/NEWS b/libdockapp/NEWS index b65db12..2556212 100644 --- a/libdockapp/NEWS +++ b/libdockapp/NEWS @@ -1,10 +1,9 @@ This file is maintained by dtorrance@monmouthcollege.edu, and available from http://libdockapp.sourceforge.net - -News for dockApp developers. +News for for all libDockApp users. ---------------------------------- -This file contains a reverse chronology of important additions and API-changes. +This file contains a reverse chronology of changes. The contents of this file will apply mostly to developers of dockapps. Please read this when you update. @@ -44,10 +43,12 @@ Please read this when you update. icon window (DAIcon), but in "windowed mode" this is the leader window (DALeader). +20030131: + Bumped the version of the library to 2. 20030130: - Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in normal window - mode will have a proper close-button now. + Added WMProtocol for WM_DELETE_WINDOW. Dockapps run in "windowed + mode" will have a proper close-button now. Child windows of a dockapp are now mapped as well when calling DAShow(). @@ -56,19 +57,99 @@ Please read this when you update. pixmaps by hand. This removes a lot of the complex parts of the example. + Revamped the Changelog. Changedates have become important now that we + use them for backward compatibility. 20030126: - The function DAGetDisplay() has been renamed to DAOpenDisplay(). This - is unfortunate for backwards compatibility, but it was a bad name for - the function, and I needed the name for another function. + Added expected against actual version matching system. This has the + purpose of keeping the library backward compatible, even when the API + changes (as happened with DAGetDisplay). + Use the function DASetExpectedVersion() in your dockapp + to ensure backward compatibility. - New functions DAGetDisplay(), DAGetWindow(), DAGetLeader(), - DAGetDepth(), DAGetVisual(), and their Set... couterparts - (DASetDisplay(), etc) were added. These get and set the global - DA...-variables (see: dockapp.h), and are mainly for use from within - code that is not directly connected to the library (e.g. from within - another library). + !!! COMPATIBILITY WARNING !!! + Renamed DAGetDisplay() to DAOpenDisplay(). The function opened a + display, this name makes more sense and there was a potential namespace + conflict (see below). - A system to match the expected version of libDockApp against the linked - version was added, to prevent backward compatibility problems in the - future. + Added functions: + Display* DAGetDisplay(char *display, ...) + Window DAGetWindow() + Window DAGetLeader() + int DAGetDepth() + Visual* DAGetVisual() + DAGetDisplay(Display *display) + DAGetWindow(Window window) + DAGetLeader(Window leader) + DAGetDepth(int depth) + DAGetVisual(Visual *visual) + These functions just wrap the global variables DADisplay, DAWindow, + DALeader, DADepth and DAVisual. The globals are still available, and + will probably remain in future releases (The wrappers are for calls + from other dynamic objects). + If DASetExpectedVersion is before 20030126 (or not set), DAGetDisplay + will behave in the old way, opening the display instead of reading out + the variable. The NEW version of DAGetDisplay should be called as: + Display *d = DAGetDisplay(NULL); + +20021220: + Added event handling for DestroyNotify, EnterWindow and LeaveWindow. + +20021016: + Added a more complex example ("rectangles") showing the use of 'action + rectangles' and the handling of _all_ recognised event types; this one + may need some simplification. + Added an example ("shapes") of using the shaped pixmap API. No code + yet, just a directory. + +20020926: + Added programming examples. There are three examples in the make: A + relatively simple example ("basic") without event handling and with + only basic shape implementation. + +20020924: + Added a 7-segment display font. This font was donated by Jim Knoble. + Thanks Jim (It doesn't get installed, yet. I still need to make a + Makefile for this...). + +20020922: + Added DAShapedPixmap type and functions to work with it. There is an + entire API around shaped pixmaps now, keeping pixmap, mask and geometry + together. It allows copying areas from both the pixmap and the mask to + another shaped pixmap, etc. + + Added new global GC: DAClearGC. If you want to draw parts, you will + also want to erase parts. + +20020921: + Added default colors as X-resources: DockApp*foreground and + DockApp*background. These colors are the foreground colors of DAGC and + DAClearGC respectively. + +20020905: + "Inherited" the project from Pascal Hofstee. He stopped maintaining it, + and gave his okay when I asked to maintain it. We used to work on this + together, I'll continue the effort alone. + + Release of libDockapp 0.4 + +Since libDockApp 0.2 +-------------------- + DockApps can now change shape on the fly. + + Motion Events are properly handled now. + + Code review/cleanup + + Added DARect and DAActionRect structures. These allow You to easily + specify regions, and functions that should be called when clicked in + these regions. + + DAEventLoop now finaly no longer causes Huge CPU-usage. + + Turned out I had to disable the GCGraphicsExposures GC-Values, which + were generating huge amounts of "NoExpose" events which were simply + discarded anyway. + +-- +Before this, libdockapp was maintained and copyright by Alfredo Kojima. diff --git a/libdockapp/examples/basic/basic.c b/libdockapp/examples/basic/basic.c index 2f94905..1ff6606 100644 --- a/libdockapp/examples/basic/basic.c +++ b/libdockapp/examples/basic/basic.c @@ -57,8 +57,8 @@ main(int argc, char **argv) "use libDockapp.\n", "Basic example version 1.1"); - /* Tell libdockapp what version we expect it to be (a date from the - * ChangeLog should do). + /* Tell libdockapp what version we expect it to be (a date from + * NEWS should do). */ DASetExpectedVersion(20020126); diff --git a/libdockapp/src/dockapp.h b/libdockapp/src/dockapp.h index edcc5f8..18442b1 100644 --- a/libdockapp/src/dockapp.h +++ b/libdockapp/src/dockapp.h @@ -143,7 +143,7 @@ extern unsigned long DAExpectedVersion; /* * Set the version of the library that the dockapp expects. * This is a date in the format 'yyyymmdd'. You can find this date - * in the ChangeLog. + * in NEWS. */ void DASetExpectedVersion(unsigned long expectedVersion);