sync with bb-cvs
[mikachu/openbox.git] / CHANGELOG.Blackbox
1 ChangeLog from Blackbox (this code's previous project):
2
3 Changes from 0.62.1 to 0.65.0:
4   - bsetroot now sets _XROOTPMAP_ID, so pseudo transparent apps will be happy
5   - beginnings of a strut implementation.  toolbar and slit are removed from
6     the available screen area if 'full maximize' is not set
7   - handle the odd edge case where a reparent event occurs while the window
8     is unmapped.  XReparentWindow sends an UnmapNotify to the window manager
9     however the window is already unmapped so the window manager never gets
10     the event and the unmapNotify event is where reparentNotify was handled.
11     Added a reparentNotifyEvent handler in the BlackboxWindow class and a new
12     case in the Blackbox class's process_event function.
13   - no more blackbox->grab/ungrab calls everywhere
14   - compression of motion and expose
15   - added a Util.cc file which contains useful functions with no obvious home.
16   - Now we have one function which turns ~/ into /home/user/.  This is now
17     called everywhere this expansion should be done.  Even added this to the
18     resource.menu_file so now the menu file may be specified as
19     ~/blackbox_menu.
20   - added a TimerQueue which is a priority_queue with the ability to release
21     items it contains before they reach the top of the queue.  Also added a
22     TimerQueueManager protocol class which BaseDisplay now inherits from.
23   - BTimer now defaults to NOT recurring.  Most of the timers in blackbox were
24     one shots so I saw little benefit in defaulting to repeating timers.
25   - added emacs local variables that prevent the addition of tabs to each file
26   - update transient handling, should solve issues with apps like acroread.
27     added a getTransientInfo() method of the BlackboxWindow class which
28     handles checking the transient state in X and setting the appropriate
29     variables on the window.  To further attack the infinite loops this
30     function ensures that client.transient != this.
31     The new transient code also allows for one window to have multiple
32     transients so applications like xmms and web browsers are better behaved.
33   - added Taiwan Chinese (zh_TW), Hungarian (hu_HU), Korean (ko_KR),
34     Norwegian (no_NO), Romanian (ro_RO) and Ukrainian (uk_UA) nls files and
35     updated the most of the others.
36   - added French man pages
37   - remove slit and netwm as compile time options
38   - strip much of BaseDisplay's original functionality and move it to the
39     blackbox class.
40   - move code over to the STL
41   - new placeWindow algorithm.  Blows the old one out of the water.  Not only
42     is it faster but it is also cleaner code too (-:  Went from number 5 in
43     the profiling to results to under 30.  Managing of new windows is slowed
44     down by image rendering above all else now.
45     Because of the new code layout, the support is now there for new and
46     different layout options, but this will wait for after 0.65.0.
47   - better window group handling
48   - huge amounts of internal cleanups
49   - even better ICCCM support and focus handling
50   - wmswallow works
51   - fix for clock clipping in the toolbar
52   - better support for non decorated windows and toggling decor
53   - the geometry window shown when moving or resizing a window now handles the
54     parentrelative setting better
55   - improved edge snap support (still no window to window snapping)
56   - changing preferences no longer leads to windows being raised
57   - the window's send to menu disables the current workspace, which is a
58     better UI approach
59   - removed several unused variables and otherwise reduced the memory usage
60     of the objects in Blackbox.  For the record we are about 100k larger than
61     0.62.0 and that is mostly due to the STL.  However for the most part
62     blackbox runs faster and is still one of the leanest window managers out
63     there today.
64   - smart window placement ignores shaded windows now
65   - new option in the Config menu which allows Scroll Lock to disable
66     Blackbox's keybindings.
67   - first the resurrection of the code and now the return of Brad!  Blackbox
68     is only getting better with age.
69
70 Changes from 0.62.0 to 0.62.1:
71   - the lock modifier code handles user redefined modifiers better
72   - check if the locale actually needs multibyte support before using multibyte
73     functions
74   - use srcdir in all of the makefiles
75   - added zh_CN (Chinese) nls support
76
77
78 Changes from 0.61.1 to 0.62.0:
79   - the immorel release
80   - added the ja_JP nls directory and man pages
81   - general code touchups
82   - blackbox-nls.hh is always generated even if --disable-nls is used.
83     This allows us to not have all of those hideous #ifdef NLS chunks.
84     Nothing to worry about, if you do not want NLS this does not affect you
85   - Workspace::placeWindow() cleanups.  Also a speed bump from reducing the
86     use of iterator->current() and changing the delta from 1 to 8
87   - cleanups to compile with g++ 3.0
88   - make distclean actually removes Translation.m and blackbox-nls.hh.
89     Also fixed Makefile.am to pass --foreign instead of --gnu when calling
90     the autotools.
91   - fixed a desciptor leak in BScreen::parseMenuFile, seems opendir
92     lacked a matching closedir.
93   - fix transient window handling code in Workspace::removeWindow() so
94     transients give focus back to their parents properly.  The code originally
95     handled sloppy focus then transient windows, so we just flopped the
96     if/elsif.  This is immediately noticable with web browsers and their open
97     location windows.
98   - plugged a small leak in ~Toolbar
99   - fixed list::insert so you really can insert at item number 2.  While there
100     I cleaned up the code a bit.
101   - added decoration to the atom state stored in a window
102   - fixed a typo in bsetroot.cc: 'on of' -> 'one of'.
103   - fixed the window menu gets left open when another window button is pressed
104     issue with a call to windowmenu->hide() in window->maximize()
105   - applied xOr's patch for decoration handling
106   - applied xOr's patch for the maximize, shade, unmaximize bug
107   - applied Kennis' patch for sending incorrect Slit configure notices
108   - BlackboxWindow's flags have been moved into a flags structure
109   - applied xOr's patch for border handling
110   - resizing a window turns off its maximized flag.  Before a resized window
111     thought it was still maximized and maximizing a double action
112   - BlackboxWindow::withdraw no longet sets the state to Withdrawn.
113     This confused some X clients.
114   - updated the manpages and added Dutch NLS support (thanks Wilbert)
115   - added it_IT nls files, thanks Luca Marrazzo <marra.luca@libero.it>
116   - the menu file mentioned in the manpage is now based on DEFAULT_MENU
117   - configure script found basename in -lgen, but did not set HAVE_BASENAME
118     causing compilation problems on irix and possibly others.  Added a call
119     to AC_DEFINE in AC_CHECK_LIB to fix this.
120   - menu is no longer installed, you need to copy it yourself
121   - cleaned up i18n code a little.  Several member functions were declared
122     but never used and getMessage() had a default argument which was also
123     never used.
124   - i18n will now compile cleanly on machines without nl_types.h
125   - the lock modifiers no longer stop blackbox!
126   - maximize a window via bbkeys and the maximize button is not redrawn, fixed
127   - now exit with an error code if an unknown option is passed
128   - autoraise and multiple dialog windows yields segv bug fixed
129     also lengthened the default auto raise delay from 250 to 400
130   - another iteration of autoraise and dialog box handling, this time we
131     noticed that nothing ever reset blackbox.focused_window to 0 when a window
132     was removed
133   - check if the window is visible before changeBlackboxHints() calls maximize
134   - placeWindow no longer takes edgeSnapThreshhold into account
135   - ignore style files ending in ~
136   - support locale specifiers with @euro in them
137   - added Slovenian man pages and nls, thanks Ales Kosir
138   - Toolbar name editing buffer reduced to 128 chars, logic added to make sure
139     this buffer is not overrun
140   - added German nls files, thanks Jan Schaumann
141   - added my name to the code, updated the version output
142
143
144 Changes from 0.61.0 to 0.61.1:
145   - fixed some of the code to explicitly use colormaps so that when
146     blackbox decides to use a non-default visual everything will
147     still work (although it may look darn ugly)
148   - optimizations to the deiconify/raising code to (hopefully) deal
149     with a rather nasty bug, plus make things a little more efficient
150   - changed the code so that the close button is always redrawn on
151     button release events, just in case the client decides not to
152     close in response to the message (see Acroread)
153   - tinkered with the Makefiles again to make sure Blackbox
154     completely cleans up after itself during an uninstall
155   - fixed a glitch in window placement that was making Blackbox
156     place some larger windows at coordinates near 2**31
157   - merged in a patch from nyz which fixed a bug with not sending
158     configure events when a window is both moved and resized (eg
159     when the left resize grip is used) as well as optimized some
160     of the show/hide code to use the stacking order
161   - fixed a bug in blackbox's support of the X shape extension...
162     it wasn't correctly resetting the bounding region after a window
163     was resized
164   - fixed a glitch with the geometry window where it would persist
165     if the client was unmapped while in motion
166   - tweaked the code for decorating transient windows so that it
167     is possible to use MOD1+Mouse3 to resize transients as long as
168     there is not some other reason to disable functions.resize
169
170
171 Changes from 0.60.3 to 0.61.0:
172   - added slightly updated copies of the blackbox/bsetroot manpages.
173   - reworked the Windowmenu code so that using the second mouse
174     button on the Send To menu moves you along with the window
175   - merged in bsd-snprintf.(h|c) from openssh so that Blackbox can
176     compile on older boxes without (v)snprintf in their standard lib.
177   - fixed a pair of problems where blackbox was not returning icons
178     and slit apps to a useable state at shutdown
179   - fixed a problem with menus not getting layered correctly after
180     a reconfigure or menu reload
181   - changed the behavior of the various MOD1+ButtonPresses on windows...
182     they should now be more consistent with the button behavior on the
183     decorations :
184             . MOD1+Button1 raises and moves the window (unchanged)
185             . MOD1+Button2 lowers the window (used to resize the window)
186             . MOD1+Button3 resizes the window (new button combo)
187   - fixed a small but _extremely_ annoying bug exposed by cvsup
188   - styled frames are now a thing of the past... the textures formerly
189     known as window.frame.(un)focus have been replaced by solid colors
190     window.frame.(un)focusColor... the thickness of the frame is now
191     determined by frameWidth, which will default to bevelWidth if not
192     specified
193   - middle clicking on a window in a workspace's window list now moves
194     the window to the current workspace
195   - fixed a minor glitch with the appearance of window labels for
196     certain newly-started apps (i.e. rxvt)
197   - added a new configure option for both the toolbar and the slit --
198     autohide. Hopefully this should help quell the demands for the
199     removal of the toolbar...
200   - added code to better handle apps that change the window focus
201   - changed the command execution code (used to handle rootCommands
202     and executable menu items) to be more robust... compound commands
203     should now work
204   - a new-and-slightly-improved implementation of unstyled frames should
205     mean slightly better performance than previously
206   - fixed a couple of stupid bugs in the new code for handling
207     Solid Flat textures more efficiently
208   - fixed the nls makefiles so that they respect DESTDIR, behave better
209     if you reinstall over an existing installation, and actually remove
210     their files on a make uninstall
211   - added cthulhain's bsetbg script to the util directory... see the
212     file README.bsetbg for more information
213   - added Estonian, French and Danish translations
214
215
216 Changes from 0.60.2 to 0.60.3:
217   - put in a (temporary?) fix for a bug with the new way icons are
218     handled. Previously an icon was created only for non-transient
219     windows, which means that 1) minimized transient windows were
220     not getting cleaned up at shutdown, and that 2) one could
221     conceivably lose access to a minimized transient if there were
222     a break in the transient chain.
223
224     For the time being, every iconified window gets an icon. In
225     order to make this a little nicer, if a window doesn't provide
226     an icon title, the window title is used in the icon menu, rather
227     than 'Unnamed'.
228   - fixed a bug in handling the destruction of intermediate
229     transient windows. The code was leaving the transient of a
230     destroyed window with a reference to the now non-existent
231     window. This can lead to all sorts of problems.
232   - fixed a slight positioning error when the slit is on the right
233     side of the screen
234   - included a new style, Minimal, which is designed for use on 8-bit
235     displays. It tries to use a bare minimum of colors, and with the
236     new code regarding Flat Solid, should consume very little memory.
237   - made yet another alteration to the way focus changes after a window
238     closes under ClickToFocus. Blackbox now tracks the stacking order of
239     all windows and uses this information to give the focus to the topmost
240     window.
241   - new configure option :
242         --enable-styled-frames   include support for fully-styled window
243                                  frames -- these are the decorations which
244                                  are affected by the window.frame* theme
245                                  entries. This option is turned on by
246                                  default.
247
248                                  Because of the way they are implemented,
249                                  these are typically the most memory and
250                                  render intensive of the various blackbox
251                                  decorations, even if they are typically
252                                  only a pixel or so wide. Disabling this
253                                  feature can result in a substantial
254                                  decrease in X memory usage, but it's
255                                  enabled by default to remain compatible
256                                  with previous versions.
257
258   - added a whole mess of logic so that blackbox will use
259     XSetWindowBackground for Flat Solid textures instead generating
260     a pixmap (which would be subsequently cached)... should help cut
261     down some on the X memory usage
262   - altered the behavior of the BImageControl timer... now it will
263     fire every cacheLife minutes, regardless of when anything has
264     been removed from the cache
265   - modified the NLS build code yet again... at this point we've
266     hopefully hit the least common denominator and it should work
267     for everyone
268   - dealt with a possible problem in the BlackboxWindow constructor
269     where we referred to a member after deletion
270   - removed a last lingering bit of the allocate()/deallocate() code
271   - fixed a pair of string formatting problems
272
273
274 Changes from 0.60.1 to 0.60.2:
275   - updated README.bbtools, since bbpager and bbkeys were updated to work with
276     0.60.x (also removed the .diffs from the source tree)
277   - fix for compiling with NLS support on Solaris
278   - added Turkish, Russian and Swedish translations
279   - applied patch for more correct Spanish translations
280   - added completed pt_BR (Brazillian Porteguese) translation
281   - removed mem.h and the allocate()/deallocate() calls throughout blackbox
282     these have been unused for a long time, and needed to go away :)
283   - compile fixes for --enable-debug
284   - changed the font loading/drawing code... XFontSets are only used if
285     the locale is set properly.  So you can still compile with nls support,
286     but do not set your LANG environment variable, and your fonts will be
287     loaded and drawn the old way
288   - smarter Basemenu::drawItem() code added, i noticed alot of flicker when
289     moving menus, because of code constantly redrawing menus items... this
290     has been significatly modified and sped up quite a bit
291   - fixed a bug where iconified windows wouldn't remove themselves from the
292     icon menu when they unmapped/closed themselves (which would result in a
293     crash if you selected this dead item)
294   - fixed a potential crash in Workspace::removeWindow() that had relation
295     to focus last window on workspace... one person experience gibberish being
296     displayed, another experienced a crash
297   - fixed a flicker problem when changing focus between windows rapidly
298     (the toolbar's window label was getting redrawn twice per focus, not
299     optimum behavior)
300   - fixed the infamous bsetroot segfault... this was quite a feat... took 3
301     people in excess of 8 hours to find... and it was a simple one line change
302
303
304 Changes from 0.51.3.1 to 0.60.1: (note:  0.60.1 is 0.60.0 non-alpha)
305   - changed licensing for Blackbox from GNU GPL to more open BSD license
306     see the file LICENSE
307   - removed alot of empty files that did nothing but passify automake/autoconf
308     Blackbox now passes --foreign to automake to lessen the requirements for
309     files like NEWS,AUTHORS,COPYING,README,etc.
310   - new configure options:
311         --enable-ordered-pseudo this enables a new algorithm for dithering
312                                 on pseudocolor (8 bit) displays... a noticable
313                                 pattern is visible when using this.  you may or
314                                 may not like it... just something different
315                                 if you want it, but is turned off by default.
316
317         --enable-debug          turn on verbose debugging output... this
318                                 isn't very complete or really very helpful...
319                                 right now it just describes memory usage and
320                                 tracks a few X event handlers... this is turned
321                                 off by default
322
323         --enable-nls            turn on natural language support... this option
324                                 will turn on the use of catgets(3) to read
325                                 native language text from any of the supported
326                                 locales (see the nls/ directory for current
327                                 translations)...
328
329                                 This option also turns on the use of XFontSets,
330                                 which allows the display of multibyte
331                                 characters, like Japanese or Korean.
332                                 This option is turned on by default.
333
334         --enable-timed-cache    turn on/off the new timed pixmap cache... this
335                                 differs from the old pixmap cache in that
336                                 instead of releasing unused pixmaps
337                                 immediately, it waits for <X> minutes, where
338                                 <X> is set with session.cacheLife in your
339                                 ~/.blackboxrc...  this option is turned on
340                                 by default.
341
342   - changed the default menu to include a listing of workspaces (and their
343     window lists) and the new configuration menu (see below)
344   - included new default styles, contributed by regulars on
345     irc.openproject.net's #blackbox
346   - generated default "translation" catalog for the C/POSIX locale... the
347     same catalog is used for English (en_US for now, will add others
348     as necessary)
349   - included translation for Spanish (es_ES) and Brazilian
350     Portuguese (pt_BR)... if you are interested in doing a
351     translation, email me at blackbox@alug.org
352   - properties and hints added for communication with bbpager and bbkeys, the
353     two most common "blackbox addons"
354   - KDE 1.x support has been completely removed, pending approval of the new
355     window manager specification to be used by KDE2 and GNOME
356   - a (broken!) base for the new window manager spec was put in place, but
357     using --enable-newspec will result in code that will not compile
358   - added a timer class to handle internal timeouts without using
359     getitimer/setitimer/SIGARLM... this will enable other things to be done,
360     as any number of timers with any timeout can be used
361   - Blackbox will search for the highest depth supported by each visual on
362     each screen... basically this means that blackbox will try to use
363     TrueColor if a TrueColor visual exists (but it's not the default visual)
364   - menu hilite changed from being just a color to being a texture and new
365     window decoration layout... as a result the style file syntax has changed,
366     old styles for 0.5x.x will not work.  See the included styles for examples,
367     and browse by http://bb.themes.org/
368   - added support for enabled/disabled and selectable menuitems, this is for
369     use in the configmenu mostly (but is used in the windowmenu)
370   - added the Configmenu, which is insertable into your menu by using:
371
372         [config] (Catchy Label)
373
374     changes made in the configmenu take effect immediately, and are saved in
375     your ~/.blackbxrc... current tunable settings:
376
377         Focus model
378         Window placement
379         Image dithering
380         Opaque window moving
381         Full Maximization
382         Focus New Windows
383         Focus Last Window on Workspace
384
385     the window placement and focus model options will be discussed below
386   - added texture type "ParentRelative" which causes the decoration to display
387     the contents of it's parent... this is a sort of pseudo-transparent option
388     and doesn't work for all decorations... see the included style named
389     "Operation" for an example of ParentRelative
390   - added support for solid interlacing... for example:
391
392         toolbar:                raised interlaced solid bevel1
393         toolbar.color:          grey
394         toolbar.colorTo:        darkgrey
395
396     will cause the toolbar base to be draw with solid lines, one line grey,
397     the next darkgrey, the next grey, the next darkgrey, ...
398   - changed dithering algorithm for TrueColor displays from Floyd-Steinberg to
399     an ordered dither... dithering at 8bpp (Pseudocolor) can be either FS or
400     ordered, but must be selected at compile time...
401
402     NOTE:  when using ordered pseudocolor (8bpp) dithering, your
403     session.colorsPerChannel ***MUST*** be 4, otherwise your display will
404     not display *any* correct colors
405   - fixed TrueColor rendering to do aligned writes (suppresses warnings on
406     Alpha Linux machines)
407   - added support for GrayScale/StaticGray displays (completely untested)
408   - made linked lists smarter, they can now have as many iterators assigned to
409     them as you want... no more FATAL errors
410   - added the Netizen class, which is a client that has 
411     _BLACKBOX_STRUCTURE_MESSAGES listed in their WM_PROTOCOLS... these clients
412     get notified of window add, remove, focus, shade, iconify, maximize,
413     resize, etc.
414
415     the two most common Netizens are bbpager and bbkeys
416   - when loading an incomplete style, blackbox now uses default colors to
417     draw decorations (instead of the annoying "see-through" effect)
418   - added menu tag [config]... which inserts the Configmenu into your rootmenu
419   - made [include] handling smarter, it will only read regular files (it
420     won't read a directory in case you ever accidentally put one there)
421   - the slit and toolbar menus now include a placement option, which will place
422     them in various positions on the screen
423   - included a slit menu option to choose it's direction (horizontal or
424     vertical)
425   - added options to the slit and toolbar menus to have them always stacked
426     above other windows
427   - right clicking on the workspace label no longer initiates a workspacename
428     edit... right clicking anywhere on the toolbar brings up the toolbar menu,
429     which has an entry that lets you change the workspace name
430   - iconified windows no longer show up in the window list for the current
431     workspace... just in the icon submenu
432   - ClickToFocus now works like one would think, clicking anywhere in a window
433     will focus it
434   - overall... this version of blackbox has and does alot more than previously
435     just take it for a test drive and see how well you like it
436
437
438 Changes from 0.50.5 to 0.51.0:
439   - new default theme, shows off new gradients (see below)
440   - many themes updated to show off new menu bullet configuration
441   - added new source file Display.cc... it offers an easy way to connect to
442     an X display and setup screen info, this was done to make life easier
443     for John Kennis, the author of the bbtools.  Image.cc and Image.hh have
444     been modified to use classes from this abstraction, so that drop in
445     replacements are all that is necessary to update the bbtools image code.
446   - configurable menu bullet... 2 new resources for in your style file:
447
448         menu.bulletStyle:    (round|triangle|square|diamond|empty)
449         menu.bulletPosition: (left|right)
450
451   - new style resource for setting the borderWidth on menus, client windows and
452     the buttons/frame/handle/titlebar... the default theme uses a borderWidth
453     of zero... it's pretty neat
454   - udpated Image code... blackbox now supports 8 types of gradients (thanks
455     to mosfet@kde.org... in exchange for helping him get the diagonal gradient
456     code from blackbox into kde, kde gave me the source to their new gradients)
457     the 8 gradients are:
458
459         diagonal, vertical, horizontal, crossdiagonal, pipecross, elliptic,
460         pyramid, rectangle
461
462     use them just like you would normally (ie. raised elliptic gradient bevel1)
463   - merged John Kennis' patch for notifying KDE modules of windows that are
464     raised/lowered/activated(focused)
465   - new geometry window that is displayed when a window is moved/resized
466   - cleaned up code for detecting slit apps
467   - window stacking code changed to keep menus above windows, and to keep the
468     slit raised when the toolbar is raised
469   - fixed compiler error from gcc 2.95 about frame.frame in several places
470   - fixed some bugs with shaped windows that set decorations via MWM hints,
471     and also fixed bugs with such windows changing their shape
472   - more complete ICCCM compliance, default window gravity is now NorthWest
473     instead of Static...
474   - focus code revamped... window focusing is alot faster and simpler, i
475     mimicked the way TWM does it's focusing... proved much faster
476   - the window menu always has "Kill Client" as an option now
477   - fixed window stacking for windows that have multiple transients (like
478     netscape)
479   - smartplacement from 0.50.4 has been reinstated... i quickly grew tired of
480     waiting on windows to be placed with the old version (if you like the way
481     0.50.5 did it... send me an email and i'll consider making it an option)
482   - added some new signal handling code (using sigaction, if available on your
483     system)...
484   - fixed some bugs with KDE support... this makes bbpager behave properly
485   - workspace editing via the toolbar has been made a little nicer with the
486     new focus code... right clicking on the workspace label will put you into
487     edit mode, but no windows can be focused until you leave edit mode...
488     ALSO... the window that had focus when you entered edit mode will have the
489     focus returned to it after editing is finished
490   - added new option to blackbox... -rc <filename> will read <filename> instead
491     of .blackboxrc for it's base configuration
492   - the option for opaque window moves has been moved from the stylefile into
493     .blackboxrc... set the session.opaqueMove: resource to True or False,
494     depending on what you want
495   - general namespace cleanups... just stuff to make maintaining the code a
496     little easier...
497   - any form of "beta" has been removed from the version number for 0.51.x
498     i am declaring this series as "stable" so that i can begin a major overhaul
499     of blackbox, which will be done with John Kennis and Jason Kasper, two
500     very sharp guys that think the same way i do ;)
501
502
503 Changes from 0.50.4. to 0.50.5:
504   - modified and merged some patches from several contributors.  added their
505     names to AUTHORS
506   - major documentation updates
507   - added a few more platform success reports.  changed development platform
508     again :)
509   - added new texture option: Interlaced... it is an extension to the gradient
510     texture that looks really neat... it is compiled in by default but may
511     be removed with --disable-interlace
512   - let's see... where do i begin... the code for 0.51.x has been GREATLY
513     enhanced over 0.50.4 (and the stupid little compile error for KDE has been
514     fixed ;))  Blackbox has undergone major renovation... and i can proudly
515     say that this release is rock solid.  Also, i reinstated ccmalloc's tour
516     of duty, and spent several days with it stomping memory leaks in blackbox.
517     i can proudly say that there are no major memory leaks present in 0.51.x
518   - the toolbar has changed it appearance a little bit... the menu button has
519     been removed and the labels and buttons are now symmetrically placed on the
520     toolbar...  oh no!? how do you get to your icons/workspaces now?  the
521     middle click patch from Greg Barlow has been modified, enhanced and merged
522     with 0.51.x... the workspace menu now behaves just like the root menu...
523     and it can be pinned to the root window (just move it)
524   - the image code has once again been worked over... this time a local LUG
525     friend and i have hashed it out many times and into the wee hours of the
526     morning... this stuff is FAST now... before i added interlacing... we
527     had doubled the speed of the dgradient function... yes... *doubled*
528   - the code to generate error tables, color tables and other tables that are
529     used in image dithering has been rewritten, which severs the last tie to
530     window maker's wrlib that blackbox had.  i now understand why and how all
531     the code that i "borrowed" works... and it's been improved... because of
532     this change... dithering is a lot cleaner... and dithering on 8bpp displays
533     is less grainy and less obtrusive...
534   - the linked list code has also been rewritten... blackbox has been using
535     a doubly linked list, and not taking advantage of all the list's
536     capabilities (because it doesnt need them)... so the linked lists are now
537     single-link and much quicker at inserting, removing, searching...
538   - once again... the menu parsing code has been rewritten... this code is
539     very efficient and very extensible... so extensible infact that after
540     implementing the current menu syntax... i added a new tag! you can now
541     insert the workspaces list into your root menu with this:
542
543         [workspaces] (descriptive label)
544
545   - the slit menu is now spacially correct... if you want the slit in the top
546     right corner of the root menu... click the top right corner of the slit
547     menu... i think this is a little more user friendly
548   - window gravity should be better supported now... restarts and what not
549     shouldn't produce all those one pixel shifts or moves anymore...
550   - the modifiers for the keygrabs in blackbox are now configurable...
551     the "keys" are still hard wired (left/right for workspace changing, tab
552     for window cycling)... but you may now configure which modifiers to use
553     with the key combos...  this introduces two new resources into your
554     .blackboxrc:
555
556         session.workspaceChangeModifier
557
558     and
559
560         session.windowCycleModifier
561
562     these resources may be set to any combination of the following:
563
564         Control Mod1 Mod2 Mod3 Mod4 Mod5 Lock Shift
565
566     also... for convenience... "Alt" is parsed as "Mod1"...
567     session.workspaceChangeModifier defaults to "Control" and
568     session.windowCycleModifier defaults to "Mod1"
569   - smart placement has been made smarter thanks to Dyon Balding's smarter
570     placement patch... this patch has been modified from the original slightly
571     (mostly speed concerns)
572   - signal handling has been made more robust... this allows it to compile on
573     more platforms and now prefers to use sigaction() over signal()
574   - over all... many code clean ups were made and old commented code was
575     purged... this is a very clean very stable release... enjoy people :)
576
577
578 Changes from 0.50.3 to 0.50.4:
579   - changed some Copyright information to include the current year
580   - added a number of platforms to the Supported Platforms section of the
581     README
582   - added the Slit... the Slit is a window maker dockapp util that lets users
583     use all of applications with Blackbox, and allows users to easily switch
584     between Window Maker and Blackbox more easily... it is included by default,
585     but you can remove it from the source with --disable-slit on your configure
586     command line
587   - large Brueghel styles and images removed from the base distribution
588   - merged a patch from Benjamin Stewart for very robust menu parsing... this
589     patch allows for parenthesis in menu files, and works well for
590     automatically generating menus from shellscripts and programs... the menu
591     syntax has not changed... it just is understood better :)
592   - added shell style tilde-slash (~/) home directory expansion for the
593     [include] and [style] tags in menu files
594   - added some sanity to window position/gravity code to for GTK applications
595   - added Window Maker style Mod1+MouseButton1+Motion window moving (for those
596     few braindead apps that like to be positioned where no decorations are
597     visible)
598   - added a SIGCHLD handler to clean up processes started by a startup script
599     that then exec's blackbox (gets rid of all those zombie processes)
600   - added a new resource to .blackboxrc which tells Blackbox where to put the
601     Slit... editing your .blackboxrc to change this is discouraged and
602     discarded, as the Slit has a menu that lets you select where to put it
603     (click any mouse button on the slit and see for yourself)
604   - fixed a bug in the workspace renaming feature that ate all Shift keypresses
605
606
607 Changes from 0.50.2 to 0.50.3:
608   - few documentation updates
609   - fixes to let -lgen actually get linked with the executable (fixes compile
610     errors on some platforms, most notably, IRIX 6.5)
611   - a new series of styles has been added to the distribution (this accounts
612     for the increased size)
613   - fix to let 16 color servers run blackbox (colormap reduction)
614   - various bug fixes... numerous strncpy's changed to sprintfs...
615   - default font set internally to "fixed" (to let it run on servers that don't
616     have any fonts installed)
617   - fixed bug to let blackbox remove all but the last workspace (instead of the
618     last two)
619   - window gravity offset changes
620   - the default key grabs have changed... there are now 4: alt-tab,
621     shift-alt-tab, ctrl-alt-right, ctrl-alt-left... these keys perform
622     as would be expected
623   - fixed wire move bug for transient windows
624   - passified error handing for the main window class
625   - fixed gravity restore for restart/exit purposes
626
627
628 Changes from 0.50.1 to 0.50.2:
629   - minimal KDE integration (configure/compile time option, turned off by
630     default).  This is unfinished and i can't really say if i ever will finish
631     it, but there is enough there to integrate the panel and other modules
632     with Blackbox.
633   - changed the regexp in building menus to use a comma (,) as the separator,
634     instead of a period
635   - various bug fixen (like the one where the window list would stay put after
636     the workspace menu went away)
637   - some hacks to improve speed in the LinkedList routines
638   - new stacking method (to better integrate with the KDE support)... windows
639     are no longer in different "levels", raising windows brings them ALL the
640     way to the front (so it's possible to obscure override redirect windows
641     like image splashes etc.) and lowering throws them ALL the way to the
642     back (even under kfm's icons)... however, the rootmenu and the toolbar
643     (if configured to be ontop) will be placed above raised windows
644   - sticky windows have changed due to the new stack implementation, they can
645     be anywhere in the stack (and not always ontop or onbottom)
646   - session.screenNUM.toolbarRaised resource has changed to
647     session.screenNum.toolbarOnTop
648   - the workspace label in the toolbar is sized a little more sanely now
649     (i found that it looks the best when the workspace label width == clock
650     label width)
651   - colormap focus now has it's own resource, session.colormapFocusModel, which
652     is set to "Click" by default, which means you have to click a window's
653     decorations or the root window to (un)install a colormap... setting this
654     resource to "FollowsMouse" will work just as it says... the window under
655     the pointer will have it's colormap installed
656
657
658 Changes from 0.50.0 to 0.50.1:
659   - eliminated the need for XConvertCase... workspace editing should now print
660     any and all characters correctly
661   - added check for libgen.h (which provides the prototype for basename() on
662     some systems, like OpenBSD)
663   - some code obfuscation (i've been removing comments, as some of them don't
664     relate to some of the code below them... i plan on recommenting the code
665     some time soon)
666   - clicking button 3 will hide ANY menu now, and in the case of the workspace
667     and or client menus, any other menus and/or buttons associated will be
668     closed as well
669   - added a patch for multi-screen which sets the DISPLAY env variable so that
670     items selected from one screen don't show up on another... many thanks to
671     F Harvell <fharvell@fts.net> for this
672   - fixed a clock bug... again thanks to F Harvell for this one
673   - complete and proper window placement and window restore has been
674     implemented... windows that are partially off screen will be placed in the
675     center of the root window
676   - the toolbar's workspace label is now dynamically sized according to the
677     length of the workspace names
678   - as stated above... workspace name editing has been completely redone, i
679     discovered XLookupString() this weekend and have deemed it the function of
680     the week... any and all characters should be printed properly now
681   - window placement now has it's own resource...
682     session.screen<NUM>.windowPlacement which may be set to SmartPlacement
683     (which has been implemented) or anything else to default back to cascade
684     placement
685   - a new resource, session.screen<NUM>.toolbarWidthPercent has been added, and
686     should be set to an integer representing what percentage of the root window
687     width the toolbar should occupy (default has been changed back to 67)
688
689
690 Changes from 0.40.14 to 0.50.0:
691   - added util/ subdirectory to place small, utility programs to use in
692     conjunction with blackbox.
693   - updated the README... it's still vague and useless, but gives a better
694     view of whats going on
695   - the configure script now checks for a few more headers, setlocale and
696     strftime in addition to basename functions to better include support for
697     multiple arch/langs/etc.
698   - updated default menu file... made it a little more general... and made
699     the default style menu [include]'d instead of explicitly included...
700     this break off of the style menu allows for custom menus to include the
701     default style menu for a create selection of styles
702   - changed all the default styles to use bsetroot instead of xsetroot
703   - menu handling has been improved... no more than one menu at a time may be
704     visible on the desktop (save for the root menu and it's tear off menus)
705     this means that you can't have multiple window menus and the workspace menu
706     open all at once... which saves screen space and reduces clutter
707   - much of the code has been reorganzied and reformatted for better
708     readability... this consists of function name changes and function
709     "ownership" (which basically means workspaces aren't managed by the toolbar
710     itself anymore, but by a general screen class on which the toolbar can
711     operate)
712   - the workspacemenu now autohides when selecting a window from one of the
713     window lists
714   - removed many empty destructors for Basemenu subclasses to improve code
715     readability
716   - two new files, Screen.cc and Screen.hh, have been added to the distribution
717     they add the new class BScreen which was needed for the biggest change of
718     the Blackbox code base, the addition of multiple screen (i.e. multihead)
719     support.  A separate BScreen is created for each screen, and all screens
720     work inconjunction with the other... windows can't be passed between
721     screens, because the X server doesn't allow this (more investigation on
722     this later)
723   - the toolbar's clock format is now controlled by the strftime() function...
724     if configure can't find this function on your system, the old date/time
725     format is used... with strftime, clicking on the clock doesn't display the
726     date... as the date may now be part of the clock display... read the man
727     page for the strftime function to write a format string for your clock,
728     and place it in .blackboxrc (i.e.
729       session.strftimeFormat: %I:%M %p on %a, %b %d is my strftime format
730     string)
731   - the toolbar has been stripped of it's workspace responsibilities, but this
732     change has no effect on the end user.
733   - common code interspersed through out the code has been consolodated into
734     small functions and called multiple times instead of having the same or
735     similar code repeated in the same class
736   - the window startup code has been improved upon again so that shaded windows
737     are restored between restarts
738   - some ICCCM code has been updated to properly reflect the state of windows
739     while shaded or on different workspaces... this state code change should
740     also fix the JX toolkit problem of deiconifying and nothing being redrawn
741   - the main Blackbox class has been changed to purely handle X events... it
742     doesn't manage resources (save for those necessary for proper event
743     handling, like the focus model for each screen)
744   - the format of .blackboxrc has changed slightly, the session.menuFile,
745     session.doubleClickInterval, session.imageDither, session.styleFile,
746     and session.colorsPerChannel resources are unchanged.  However, the
747     following resources are screen dependant:
748
749         session.screen<num>.strftimeFormat
750         session.screen<num>.workspaces
751         session.screen<num>.workspaceNames
752         session.screen<num>.toolbarRaised
753         session.screen<num>.focusModel
754
755     where <num> is the screen number (zero being default and all that would be
756     present on a single screen/monitor setup).
757   - a utility named bsetroot (mentioned above) has been included in the
758     blackbox distribution, to aid in setting root window patterns (ala
759     xsetroot).  the only different between xsetroot and bsetroot is that
760     bsetroot doesn't redefine cursors, and doesn't restore defaults if no
761     arguments are given.  bsetroot does support multiple screens, and is ideal
762     for those setups (instead of running xsetroot for each screen)
763
764
765 Changes from 0.40.12 to 0.40.13:
766         - added some compile time parameters to allow for clean compiling
767         - added support for vertical/horizontal maximization (i did this by
768           hand, but kudos to John Martin for the idea ;)
769         - added basename() to the distribution... it will only be compiled in
770           if basename is not present in standard libraries
771         - window focus code has changed yet again... i've decided to completely
772           rewrite the focus handling code, instead of trying to fix it... let
773           me know how this does
774         - a new resource has been added to the style loader... a resource of
775           the form:  rootCommand: <shell command string> will execute this
776           command when the style is loaded, suitable for setting the root
777           window background to an image/pattern/color... this should make
778           style integration more seamless
779
780
781 Changes from 0.40.11 to 0.40.12:
782         - more migration to autoconf/automake/autoheader etc.
783         - changed the default installation prefix... /usr/local is now the
784           default... all default config files will be stored in
785           ${prefix}/share/Blackbox... any old files will not be used, and
786           should be removed
787         - a small internal rework has made the "Inverted" option for
788           pressed button textures obsolete... please update your configs
789         - Makefile.generic has been removed
790         - Laurie's tear off menu patch has been adapted into the source tree...
791           sorry Laurie, but i had to rework your patch to make it completely
792           bullet proof ;)
793         - rework of Image code... resizes and maximizations should be much
794           faster now
795         - existance of XConvertCase is checked by configure... if it is NOT
796           found, then when editing the workspace name, pressing shift will
797           not print capital letters... sorry... get an uptodate X distribution
798           (R6.3 or higher) so that XConvertCase exists...
799         - the date format on the clock is controlled by a new .blackboxrc
800           resource... session.dateFormat... accepted values are:
801                 American ( mm/dd/yy )  and
802                 European ( dd.mm.yy )
803           the default is american... if any other string is entered for the
804           resource, blackbox defaults again to american...
805         - changed some window positioning code so that windows aren't thrown
806           to the middle of the screen unless they are completely hidden when
807           shown
808         - time bugs have been fixed... this is too detailed to go into... so
809           read the source if you are curious, otherwise just hit Reconfigure
810           when ever you change the system time, and blackbox will update and
811           continue to monitor/display the correct time (also... wrt y2k...
812           blackbox is y2k compliant is your libc's localtime() is y2k
813           compliant)
814         - this release has a major internals rework... let me know of any
815           problems... i would also love to hear about improved/degraded
816           performance... enjoy people... 
817
818
819 Changes from 0.40.10 to 0.40.11:
820         - changed the blackbox distribution to use autoconf instead of
821           imake... let me know how this works
822         - removed all the Imakefiles and Imakeconfig in favor of autoconf...
823         - added necessary files for automake and autoconf
824         - fixed a bug that would automatically shift focus to the workspace
825           label after switching to an empty workspace which would edit the
826           workspace name if pressing ctrl-arrow...
827         - fixed a bug that wouldn't focus any windows with alt-tab after
828           switching workspaces
829         - new feature:  click button 1 on the clock to display today's date
830           releasing the mouse button redraws the current time
831         - implemented double-click window shading by adapting David Edwards'
832           <david@dt031n1a.tampabay.rr.com> shade patch
833         - added new .blackboxrc resource - session.doubleClickInterval - which
834           controls the time between double clicks... used by the double-click
835           shade feature... defaults to 250ms is not specified
836
837
838 Changes from 0.40.9 to 0.40.10:
839         - fixed the broken menu highlights - they are now a dot in front of
840           the menu label
841         - enhanced the image rendering code to prebuild dithering lookup
842           tables... this saves some multiply and divide instructions during the
843           rendering loop... it makes a noticable difference on my lowly p133 ;)
844         - just for completeness... i've added some error output for various
845           things that could (but rarely do) go awry
846         - the focus code has been updated yet again... but this time it's for
847           the better ;)  the ctrl arrow keys continue working after a window
848           has been closed etc. etc... this should be the final change... unless
849           i find more bugs in it
850
851
852 Changes from 0.40.8 to 0.40.9:
853         - fixed a menu bug to keep as much of the menu on screen as possible
854         - added a patch from Peter Kovacs <kovacsp@egr.uri.edu> to raise the
855           current focused window when the user clicks on the window label on
856           the toolbar
857         - changed some window gravity defaults... nothing major here
858         - focus handling code has been spruced up... and majorly tested...
859           0.40.8's focus code was about as good as a full tank of gas but
860           no corvette... let me know how the focus handles in 0.40.9
861
862
863 Changes from 0.40.7 to 0.40.8:
864         - more menu fixes... highlights are handled as normal... constant
865           highlights are draw differently... the rounded edges minus the
866           highlighted bar...
867         - hand strength reduction in the BImage::renderXImage() method...
868           this doesn't offer much of a speed up... but every little bit
869           counts
870         - stuck clients that open transients now have their transients stuck
871           by default
872         - changed some input focus code to better handle the sloppy focus
873           model... the little annoyances like two focused windows should now
874           be fixed...
875         - removed gcc specific code... changed use of strsep to strtok (which
876           is defined by ANSI C)
877         - this is strictly a maintainence release... no new features have
878           been introduced
879
880
881 Changes from 0.40.6 to 0.40.7:
882         - changed bhughes@arn.net to bhughes@tcac.net throughout the source
883           tree
884         - menu sanity fixes... like unmapping a submenu when an item is removed
885         - image code fixes... no memory is allocated during the rendering...
886           only when the BImage is created... thanks to lee.salzman@lvdi.net for
887           the frame work for these changes
888         - fewer floating point division in gradient rendering routines... again
889           thanks to lee.salzman@lvdi.net for the basis of these changes
890         - reading workspace names is now a little more robust, but probably not
891           bullet proof... events are handled normally while reading the
892           workspace name... instead of blocking them all... the label changes
893           color... and reverts back to normal when enter is pressed (which
894           applies the new workspace name)
895         - the window geometry label drawn during window resizing has moved to
896           inside the window frame, this allows us to see what size windows are
897           being resized to when the right edge is close to the edge of root
898         - a lock system has been implemented for the blackbox objects... this
899           fixes a nasty little problem of stale windows (decorations with no
900           client window) because of on object grabbing the server and another
901           unlocking it... the current system works similar to XLockDisplay
902           (which is used in threaded X programs).
903         - icccm code enhancements for XWMHints and NormalHints
904         - window maximizing now properly returns the maximized client to its
905           previous location (this is a bug fix... maximize netscape, then
906           maximize an xterm... unmaximizing netscape will put it where the
907           xterm was previously)
908
909
910 Changes from 0.40.5 to 0.40.6:
911         - the workspace and client menus now keep the current workspace and
912           focus window highlighted so that we know which window is in focus
913           (especially useful with multiple xterms in the same workspace)
914         - image dithering code has been updated slightly to hopefully squeeze
915           every last drop of performance out of it
916         - pixel computation has been simplified
917         - gradient code has been changed to use less floating point division
918           this breaks Jon Denardis' gradient hack, but the option has been
919           left in place in case Jon wants to re-implement it :)
920         - more ICCCM compliance code added... window colormap focus has a
921           click-to-focus policy... any window that wants to use it's own
922           colormap (i.e.  netscape -install) will have it's colormap installed
923           when button1 is pressed anywhere on the decorations (like when
924           raising)  the default root colormap is reinstalled when pressing
925           button1 on the root window
926         - workspace names can now be changed on the fly... they are stored in
927           the users ~/.blackboxrc file, and may be edited from there, although
928           any changes made to the file will be over written when blackbox is
929           shutdown or restarted...
930         - workspace names can be edited *while blackbox is running* by pressing
931           button3 on the workspace label on the toolbar... pressing enter ends
932           the edit and normal event processing resumes... these names are saved
933           on exit/restart for convienence
934         - support for window gravity has been added... this is addition is
935           another step closer to complete ICCCM compliance
936         - window resizing is a bit more sane now... a bug once pointed out long
937           ago that i never noticed plagued me the other day... when resizing a
938           window to a large size... blackbox can delay a bit while it renders
939           the new decorations... if the user tries to move the window before
940           these decorations are finished... the window is resized again... this
941           has been fixed
942
943
944 Changes from 0.40.4 to 0.40.5:
945         - updated the default style to reflect the button resource change in
946           0.40.4
947         - added internal menu alignment
948         - added internal linked list insertion at a certain point, used in
949           menus
950         - submenus now update their parent menu to reflect that the submenu
951           is no longer open
952         - right clicking anywhere on the rootmenu or window menus will now
953           unmap them... NOTE: this doesn't work on submenus or the rootmenu
954           or on the SendToWorkspaceMenu
955         - cleaned up some of the image rendering code to use less comparisons
956           while rendering an image... also removed alot of
957           multiplication/division use in beveling loops to increase speed
958         - changed dithering error distribution to make images smoother at
959           15 and 8bpp (8bpp got the most benefit from this change)
960         - changed the toolbar appearance... removed the raise/lower button,
961           changing the level of the toolbar isn't possible as of yet... a new
962           button has been added on the left of the toolbar, pressing it will
963           map the workspace menu, which has a few changes
964         - the workspace menu now conatins submenus of all the window lists of
965           all workspaces... it is now possible to see which window is on which
966           workspace... also... the icon button has been removed from the
967           toolbar and the iconmenu is now a submenu of the workspace menu
968         - window placement has been slightly modified... if clients request a
969           certain position, the request is honored, otherwise the client is
970           cascaded... if either the cascade or requested position obscures part
971           of the window when the window is created, the window is centered in 
972           the root window...
973         - window state updated... when blackbox is restarted, all client
974           windows are placed on the workspace they were previously occupying...
975           this is only between restarts... not when X is restarted...
976           however... applications may be coded specifically for blackbox to
977           start on a certain workspace... for more information on this, email
978           me
979         - window menu placement has been made a little more sane
980
981
982 Changes from 0.40.3 to 0.40.4:
983         - removed the window.handle{.color,.colorTo} resources... the handle
984           is now treated as a button, and uses the button resources
985         - added window.focus.button and window.unfocus.button resources to the
986           style file... this allows colors to be set different from the
987           titlebar... the colors are controlled with window.focus.button.color,
988           window.focus.button.colorTo, window.unfocus.button.color and
989           window.unfocus.button.colorTo
990         - transient focus policy has changed... if any window has an open
991           transient window... focus is awarded to the trasient instead of the
992           parent window, even if the mouse doesn't occupy the trasient window
993         - cleaned up some namespace in Basemenu.cc and Basemenu.hh
994         - changed dithering error diffusion
995         - fixed Bevel2 so that it doesn't sig11 anymore
996         - changed stacking code slightly... "stuck" windows now are placed
997           in relation to the toolbar... i.e. if the toolbar is on top... stuck
998           windows are on top of any other client windows... if the toolbar
999           is underneath client windows... stuck windows are also stacked
1000           underneath the client windows
1001         - major reworking of Window.cc and Window.hh to fully support the
1002           _MOTIF_WM_HINTS on client windows... if this hint is present... then
1003           the window is decorated according to those hints... all the move/
1004           resize/configure code had to be updated because of this... one step
1005           closer to gnome compliance
1006         - window menus now contain different items based on the functions
1007           available to the client window... if a window cannot be maximized...
1008           then no maximize item is present in the window menu... also, "Close"
1009           and "Kill Client" are no longer present at the same time... if the
1010           client supports the WM_DELETE_WINDOW Protocol, then "Close" is
1011           present, "Kill Client" is only present for clients that do not
1012           support the protocol
1013         - windows may now be moved by the titlebar, handle or thin border
1014           around the window... window menus are also accessible by pressing
1015           button 3 on any of these 3 windows
1016         - a new focus model has been added... it works... but is mostly
1017           untested... session.focusModel: AutoRaiseSloppyFocus in .blackboxrc
1018           will retain the sloppy focus model... but raise windows to the
1019           top when focused...
1020
1021
1022 Changes from 0.40.2 to 0.40.3:
1023         - fixed a bug in Blackbox::nextFocus that would put blackbox into an
1024           infinite loop when 2 windows where open, window 0 was iconified and
1025           window 1 had focus and pressing alt-tab or the next window button
1026           on the toolbar
1027         - completely recoded all the graphics stuffs to support all visual
1028           classes and color depths, also the image code is more compact and
1029           faster than previous releases
1030         - removed graphics.cc and graphics.hh from the distribution and added
1031           Image.cc and Image.hh for the new graphics implementation.  a new
1032           class called BImageControl is now in charge of all pixmap caching
1033           and color allocation on displays that don't run/support TrueColor...
1034           this takes the job away from the Blackbox class... whose job is now
1035           to manage all it's children and disperse events read from the display
1036         - fixed bug that didn't handle windows created before blackbox is
1037           running (again :/)
1038
1039
1040 Changes from 0.40.1 to 0.40.2:
1041         - added a variable initialize line of code to keep blackbox from
1042           splattering from a sigsegv on startup
1043
1044
1045 Changes from 0.35.0 to 0.40.1:
1046         - cosmetic menu rendering fixes, changed the way the submenu dot is
1047           sized; changed an off by one error in drawing the rounded edges;
1048           fixed the text to be draw in the center of the item instead of at the
1049           bottom
1050         - major changes to the toolbar (formerly the workspace manager) to
1051           change the way it looks and works.  The large blank space is gone,
1052           and the toolbar is now half the height it used to be (roughly). the
1053           workspace label displays the current workspace, with the workspace
1054           menu accessible by clicking button 1 on the label. the two buttons
1055           directly to the right of the workspace label change the workspace
1056           when pressed. the window label displays the current focused window,
1057           which makes it easier to identify which window has input focus (for
1058           some people like me that have very dark or very closely colored
1059           decorations).  the window menu is accessible by pressing button
1060           one on the window label, and selecting an item from the window menu
1061           will set input focus to that window (if it can receive focus). the
1062           two buttons to the right of the window label circulate focus (up and
1063           down, respectively) through the window list, skipping windows that
1064           cannot receive focus.  the icon button displays a menu of all
1065           iconified applications.  both the icon menu and the window menu will
1066           not become visible if they are empty.  the next button on the toolbar
1067           is a raise/lower button for the workspace manager. the toolbar is
1068           stacked on startup according to the resource set in ~/.blackboxrc,
1069           but this button will raise and lower the workspace to the users
1070           desire, saving the stack order when blackbox is exited or restarted.
1071           the clock is still the same, but editing the session.clockFormat
1072           will change it from normal time (session.clockFormat: 12) to 24hour
1073           format (session.clockFormat: 24)
1074         - a pixmap cache has been implemented. a linked list stores all images
1075           rendered, removing them from the list and freeing them with the X
1076           server when all applications have removed references to them. for
1077           those who start man instances of the same applications will benefit
1078           greatly from this, as the same decorations are not redraw for each
1079           and every window.  this greatly reduces the load on the X server
1080           (my X server went from taking 20-28mb of memory to 8-11mb, a dramatic
1081           improvement, especially on this 32mb machine).  as a result of this,
1082           reconfiguring is faster, as is startup and restarting.
1083         - click to focus has been implemented, with some restrictions. other
1084           window managers allow the user to click anywhere on the decorations
1085           OR the client itself to set focus.  i have not found an elegant way
1086           to do this yet, so focus can only be set by pressing button 1 on
1087           the decorations (like the titlebar, handle, buttons, border, etc.)
1088           just not on the client itself.  i am looking more into this, but
1089           don't expect anymore than what is in place now.  to use
1090           click-to-focus, put session.focusModel: ClickToFocus in ~/.blackboxrc
1091         - 2 new commands have been added to the menu syntax, [include] and
1092           [style]... the [reconfig] command still has the option to reconfigure
1093           after a command has been run, but probably will be faded out...
1094           [include] (/path/to/file) includes the file inline with the current
1095           menu, meaning that a submenu isnot created for the separate file,
1096           if a submenu is desired, the file should include the [submenu] and
1097           [end] tags explicitly.
1098           [style] is a new addition for the style file support. syntax is:
1099           [style] (label here) {/path/to/style/file} which will read the new
1100           style file and reconfigure when selected.
1101         - style files have been added to allow for easier switching between
1102           configurations.  the style file resources are dramtically different
1103           from those in 0.3x.x, see app-defaults/Blackbox-style.ad for an
1104           example...
1105         - with the addition of style files, menus have been given their own
1106           justification resource, allowing (for example) menus to be left
1107           justified while titles are center or right justified.
1108         - please read the sample configuration files in app-defaults/ for the
1109           new and improved configuration system.  NOTE: Blackbox.ad is a
1110           sample ~/.blackboxrc, but you shouldn't copy this file to
1111           ~/.blackboxrc, as Blackbox will store the resources it needs
1112           automatically
1113         - an unofficial release numbered 0.40.0 was given out to some 
1114           testers, and even this release needs the same treatment as 0.35.0
1115           with respect to the new config system (0.40.0 only implemented the
1116           pixmap cache, the new toolbar and *part* of the new config system,
1117           but not the style files or automatic generation of ~/.blackboxrc)
1118
1119
1120 Changes from 0.34.5 to 0.35.0:
1121         - changed the way menus are draw to round both end of the highlight...
1122         - cosmetic enhancements for the various justifications...
1123         - this is the first stable release of blackbox
1124
1125
1126 Changes from 0.34.4 to 0.34.5:
1127         - hopefully... this will be the last bug fix... so i can begin working
1128           on new features... i fixed event mask selection on client windows
1129           after reparenting them to the decoration frame... this should get
1130           xv working again...
1131         - changed the signal hander to core on sigsegv and sigfpe... sigint and
1132           sigterm will just exit blackbox cleanly... sighup will cause blackbox
1133           to reconfigure itself
1134         - changed the way the version string is printed... 
1135
1136
1137 Changes from 0.34.3 to 0.34.4:
1138         - changed the window stacking code to stack windows and their menus
1139           more sanely... window menus are stacked directly ontop of the client
1140           windows... instead of on top of every other client window... the
1141           workspace manager is now by default stacked above client windows...
1142         - reworked alot of code in Window.cc, blackbox.cc, Workspace.cc and
1143           WorkspaceManager.cc to properly handle ICCCM state hints... the
1144           startup and shutdown code has been completely reworked as a result of
1145           this
1146
1147 Changes from 0.34.2 to 0.34.3:
1148         - this was a small change in the code... but a BIG change for the user
1149           base... the X error handler is now non fatal... yes... this means if
1150           blackbox encounters an X error (like a bad window or a bad match) it
1151           will fprintf() the error and continue running... the quick window bug
1152           has been mostly fixed... i have a small app that i wrote that quickly
1153           maps a window, calls XSync()... then destroys the window and exits...
1154           the first time i ran this little beauty... blackbox died a horrible
1155           death... blackbox now handles this app nicely... but does
1156           occasionally report an error (during the decoration creation... which
1157           is promptly destroyed from the destroy notify event placed in the
1158           queue by the X server... thus... no memory leaks... no memory
1159           corruption... blackbox just keeps chugging along nicely
1160
1161
1162 Changes from 0.34.1 to 0.34.2 (unreleased):
1163         - fixed MSBFirst byte order image rendering at 32bpp (24bpp pending)
1164           (for machines better than this intel machine of mine)
1165         - changed BImage to allocate dithering space when the image is created
1166           and to delete it when the image is destroyed... instead of allocating
1167           the space and deleting the space each time the image is rendered to 
1168           an XImage... hopefully this will provide a speed increase (albeit a
1169           small one)
1170         - changed blackbox to call XListPixmapFormats once at startup...
1171           instead of each time an image is rendered... this should afford some
1172           speed increase (a small one at best :)
1173         - fixed a bug in Window.cc that re-reads the window name...
1174           Jon Denardis discovered this bug while playing with netscape 4.5...
1175           the validation call is now directly before the XFetchName call...
1176           instead of before an if() { } block that calls strcmp and XFree()
1177         - edit Window.cc to change the way buttons are decorated and sized
1178           the associatedWindow.button.color(To) resources have been removed,
1179           but the associatedWindow.button texture resource is still there
1180
1181
1182 Changes from 0.34.0 to 0.34.1:
1183         - fixed the unmanaged rxvt/xconsole/whatever problem that didn't
1184           decorate windows at start up... just a little logic error that was
1185           fixed with a few braces
1186         - fixed the shutdown code so that X and blackbox don't die a gruesome
1187           death while reparenting the small applets on the workspace manager
1188           toolbar... the above bug fixed also fixed a bug that didn't reparent
1189           any existing app windows...
1190         - updated libBox code to allow for flaws in it's design (forgotten from
1191           0.34.0)
1192         - removed #include <sys/select.h> from blackbox.cc so that it compiles
1193           on any platform (since select is supposed to be defined in unistd.h)
1194         - removed the NEED_STRNCASECMP block in blackbox.cc until i can get
1195           a working posix like routine to work (needed for OS2 platforms)
1196         - edited the Imakefile scheme to have the the toplevel Imakefile and 
1197           Imakefiles in app-defaults/ lib/ and src/... there now is Imakeconfig
1198           which includes all the options in one file... so that editing all
1199           the Imakefiles is no longer necessary
1200
1201
1202 Changes from 0.33.6 to 0.34.0:
1203         - edited some Imakefiles so that rpm creaters have an easier time
1204         - added stuff to lib/  which contains a small (VERY small) library for
1205           letting applications open a window on the workspace manager toolbar
1206           this is very very new... restarting will cause the app to crash
1207           (at best) or take X with it (the worst)... play with it an let me
1208           know how it works
1209         - further revised window.cc and blackbox.cc to provide better error
1210           checking... window.cc received the most updates... validating a
1211           window is now done in the statement before the window is used... not
1212           at the beginning of the function the window is used in...
1213         - fixed the stacking order bug when changing workspaces... the windows
1214           will now be restored in the order that you left them... not in the
1215           order they were created in...
1216         - updated the README... a little bit anyway :)
1217         - updated BlackboxWindow::maximizeWindow() in window.cc to properly
1218           maximize windows that have specified size increments
1219         - fixed BlackboxWindow::configureWindow so that shaded windows that re
1220           size themselves only resize the titlebar
1221         - added ccmalloc 0.2.3 to the main source tree to aid in debugging...
1222           this is NOT maintained by myself, see the source tree for details
1223         - eliminated a double delete call with the aid of ccmalloc!@#!
1224         
1225
1226 Changes from 0.33.5 to 0.33.6:
1227         - added Makefile.generic for those of you with foobared imake configs.
1228           the use of xmkmf -a (i.e. imake) is still prefered... but this should
1229           work on any system... with a little editing
1230         - added static int handleXErrors(Display *, XErrorEvent *) in
1231           blackbox.cc to handle any and all X lib errors while blackbox is
1232           running... this should produce a coredump and thus the -moron
1233           community should be able to flood my inbox with stack trace upon
1234           stack trace :)
1235         - added some sub directories and moved the sources around, this allows
1236           for easier inclusion of the library for blackbox specific programs
1237           (which will run in the dock)
1238         - hopefully fixed the "disappearing-rxvt-trick"... since i can't
1239           reproduce it i don't know for sure
1240         - removed the use of alloca in graphics.cc... i was noticing very odd
1241           behaviour from malloc() and free()... where blackbox would sig11 
1242           when exiting because of XCloseDisplay doing something naughty...
1243           and this seems to have done the trick... no more sig11's from malloc
1244           or new... everything i've thrown at blackbox is gently but firmly
1245           beaten into submission...
1246         - added docboy's curved gradient hack as a compile time option... see
1247           src/Imakefile and src/graphics.cc
1248
1249
1250 Changes from 0.33.4 to 0.33.5:
1251         - added a small test to cascade windows that start out partially hidden
1252           (like netscape, Xnest, xv, etc.)
1253         - changed icon handling to include a menu of icons accessible from the
1254           workspace manager toolbar
1255         - deiconifying a window now takes it to the top of the stack
1256         - clicking on a menuitem that has a submenu no longer hides the submenu
1257         - added resource "workspaceManager.24hourClock",  a value of True turns
1258           on the 24hour clock on the toolbar
1259         - removed icon pixmap/window/mask support/handling from window.cc and
1260           window.hh... since icons are now handled in a menu, this is no
1261           longer needed
1262         - added session.handleWidth and session.bevelWidth
1263           to control window sizes (instead of hardcoded defaults)
1264         - changed parts of Basemenu.cc and WorkspaceManager.cc to follow the
1265           sizes set by session.bevelWidth
1266         - fixed Alt-Tab window switching... also fixed some focus handling bugs
1267           which let two windows become focused at the same time (which is bad
1268           mojo)
1269
1270
1271 Changes from 0.33.3 to 0.33.4:
1272         - corrected a typo in the sample Blackbox.ad file to correctly show
1273           which resource to set for the menu file
1274         - added moderate window group support for programs like netscape and 
1275           other motif applications... modified window stacking code and
1276           internal list code to support window groups (this makes transients
1277           behave properly... another step towards more complete ICCCM
1278           compliance)
1279         - modified focus event handlers to stop applications from focusing out
1280           when pressing menubars... also window focus is returned to root if 
1281           the focus window is closed... if another window is under the focus
1282           window when it is closed... that window is awarded input focus
1283         - fixed tiny little bug that didn't move the close button when resizing
1284           a window
1285
1286
1287 Changes from 0.33.2 to 0.33.3: 
1288         - changed some of the menu code ("updated" in 0.33.1) back to the
1289           original 0.33.0, which seems to perform better.  Reason behind it? -
1290           blackbox died too often with 0.33.1/2
1291         - added "Kill Client" option to window menus... for those applications
1292           that don't accept the WM_DELETE_WINDOW atom
1293         - menus that are not partially moved off the root window are shifted to
1294           a visible position when the pointer enters the frame... it is also
1295           shifted back to it's original position when left (this is new... let
1296           me know how it works)
1297
1298
1299 Changes from 0.33.1 to 0.33.2: (unreleased)
1300         - changed BlackboxIcon to not try and read its config when it was
1301           created.  This was forgotten from the 0.31.0 -> 0.33.0 move :/
1302
1303
1304 Changes from 0.33.0 to 0.33.1: (unreleased)
1305         - improved menu handling, less possibilty for SIGSEGV
1306         - menus now make copies of all label, exec strings and titles, to
1307           make less loose pointers
1308         - fixed typo to allow submenus of submenus of submenus (...)
1309         - fixed workspace menu and window list menu placements
1310
1311
1312 Changes from 0.31.0 to 0.33.0:
1313         - added #ifdef statements so the C preprocessor doesn't complain about
1314           _GNU_SOURCE being redefined.
1315         - changed internal resource data structures
1316         - added Sticky windows functionality
1317         - remove old animation code bound with #ifdef ANIMATIONS
1318         - fixed a silly little bug that sometimes mapped a submenu when its
1319           parent was unmapping itself
1320         - added ExecReconfigure option to execute a shell statement before
1321           performing reconfiguration
1322         - rearranged window config code to reduce wait time while resizing
1323         - added internal macro BImageNoDitherSolid to make window frame
1324           rendering faster (dithering a solid image is silly anyway)
1325         - added new menu file format
1326         - added Blackbox::validateWindow to provide a stabler environment for
1327           Blackbox.  This gives blackbox more error checking and greater
1328           stability.  For me, random crashes have (nearly) disappeared.
1329         - removed window name/class dependant frame texture/color
1330         - with 0.31.0, each entity read it's configuration from the rc database
1331           loaded at start.  this has changed back to the old behaviour of
1332           reading all configuration parameters at start, no database reads are
1333           performed after the initial setup (save for reconfiguring).
1334         - configuration has changed to be a little cleaner, and a little more
1335           thorough.  See the Blackbox.ad and BlackboxMenu.ad for exmaples.
1336