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