dockapps/libdockapp/NEWS

This file is maintained by wmaker-dev@lists.windowmaker.org, and available
from http://windowmaker.org/dockapps/?name=libdockapp.

News for 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.

20141128
	Release of libdockapp 0.6.4.
	Source code cleanup.
	Now maintained by Window Maker Developers Team.

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 multi-character 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().

	Reworked basic example to use a Window instead of drawing and erasing
	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:
	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(<changelog date>) 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.