wok: unclutter/description.txt annotate

wok annotate unclutter/description.txt @ rev 22491

updated apr and apr-dev (1.4.6 -> 1.7.0)

rev	line source
al@18872	1 unclutter is a program which runs permanently in the background of an X11
al@18872	2 session. It checks on the X11 pointer (cursor) position every few seconds, and
al@18872	3 when it finds it has not moved (and no buttons are pressed on the mouse, and
al@18872	4 the cursor is not in the root window) it creates a small sub-window as a child
al@18872	5 of the window the cursor is in. The new window installs a cursor of size 1x1
al@18872	6 but a mask of all 0, ie an invisible cursor. This allows you to see all the
al@18872	7 text in an xterm or xedit, for example. The human factors crowd would agree it
al@18872	8 should make things less distracting.
al@18872	9
al@18872	10 Once created, the program waits for the pointer to leave the window and then
al@18872	11 destroys it, restoring the original situation. Button events are passed
al@18872	12 transparently through to the parent window. They will usually cause the cursor
al@18872	13 to reappear because an active grab will be made by the program while the button
al@18872	14 is down, so the pointer will apparently leave the window, even though its x y
al@18872	15 position doesnt change.
al@18872	16
al@18872	17 The first version of this program used a grab to remove the cursor.
al@18872	18 This method is still available with a "-grab" option to the program.