fix for multi-head DISPLAY problem
[bbkeys.git] / ChangeLog
blob244cf9360157853d20dee665adb80f2aeda1b029
1 version 0.8.5 --
3   - fix multi-head bug in main.cc.  We now setenv("DISPLAY"...) so that
4     applications launched will be launched on the correct display.  Thanks to
5     Greg Gilbert for the patch!
6     [vanRijn]
8   - fix bug in main.cc (| rather than ||).  Thanks to Roman Neuhauser!
9     [vanRijn]
11   - fix bug in bbkeys.hh--increasing MaxInstructions to 100 for cthulhain
12     [vanRijn]
14   - fix in bbkeys.cc -- XUngrabKey changed to use same call to find what
15     screen we're on as the XGrabKey call 
16     [vanRijn]
18   - fix in bbkeys.cc -- doing "xterm -e sh -c $command" rather than "xterm -e
19     $command".  Thanks to Magnus Solvang for the bug report.  Also, changing
20     hideous char* and snprintf() to ostrstream, YAY!!
21     [vanRijn]
23 version 0.8.4 --
25   - add a sanity check to the removeWindow function. Basically, blackbox tells
26     bbkeys when a window disappears, or is removed. If the window being
27     removed was the last window blackbox specified as having the input focus,
28     bbkeys now resets what it thinks has the input focus. This prevents the
29     bug reproducable by iconifying the last window on a workspace, and then
30     trying to maximize "nothing". [xOr]
32   - cleaning up build again.  Rather than having 200 -DDEFINE_ statements
33     in our compile lines, we use config.h (like normal people).  =:)  This
34     very well may break stuff, but it looks good thus far.... [vanRijn]
36   - adding AM_MAINTAINER_MODE to stop the ever-annoying "here, let me run
37     aclocal for you again!!" idiocy of automake and friends [vanRijn]
39   - fixing things for multi-head displays--replacing
40     "getScreenInfo(0)->getRootWindow()," with
41     "getCurrentScreenInfo()->getRootWindow(),"  So yes, bbkeys now has
42     multi-head support.  Sort of.  You need to have a separate instance of
43     bbkeys running against each head ("bbkeys -display :1"), etc.  cat
44     complaints >> /dev/null.... [vanRijn]
46   - removing kludgy C command-line configurator with much-improved perl script
47     from Damien Tougas (thanks!!!) [vanRijn]
49   - changing bbkeys.cc to look for bbkeysconf.pl rather than bbkeysConfigC
50     [vanRijn]
52   - removing showAllWorkspaces from bbkeys.{bb,nobb} config file and making it
53     an additional keybinding.  This allows two different ways of showing all
54     open windows and navigating through them--one keybinding for the regular
55     "NextWindow" variety (as in previous versions of bbkeys, and another
56     keybinding, "NextWindowAllWorkspaces", that pops up the window list for
57     navigation for windows open on all workspaces.  [vanRijn]
59   - bugfix....  previously, bbkeys would ignore windows that had no name.  We
60     now follow blackbox's lead (and follow blackbox's code) and create a name
61     for it, "Unnamed".  Thanks to Damien Terrier for this bug report.
62     [vanRijn]
64   - patch for allowing an alternate keybinding config file (thanks to Scott
65     Moynes!) [vanRijn]
67   - sync with blackbox for 0.61.2--attributes element Atom has changed to now
68     include decoration state so that ToggleDecor() works. [vanRijn]
70   - including patch from Sergey Vlasov for allowing use of Meta and Hyper
71     modifiers, also try to get the correct Num_Lock and Scroll_Lock modifier
72     mask from the X server rather than hard-coded.  I've not had tons of time
73     to play with this, though I have made sure that it works on my laptop.
74     =:) [vanRijn]
76   - fix for RPM-building process... install gzipped man pages by default on
77     RPM-based systems.  Thanks to Darryll for the bug report!!  =:) [vanRijn]
79   - removing bbkeysconf and bbkeysConfigGtk *shudder* apps from
80     chain-launching mode.  These babies are dead and let's just move on
81     folks....  By keeping them in there, I'm afraid people will think it's
82     okay to use them.  It's not.  They're WAY out of date.  Also, thanks to a
83     smarter way of handling key grabbing configuration in bbconf, we don't
84     have to hang bbkeys while keygrabs are being configured. [vanRijn]
86   - adding logic to bbkeys to pass configurators correct command-line
87     arguments so we load the rc-file that our user is running bbkeys with.
88     [vanRijn]
90   - long-overdue documentation finessing, thanks to Roman Neuhauser for the
91     patches and suggestions!  =:)  Also, adding CVS version id's to all source
92     and documentation files, woot!  =:) [vanRijn]
94   - cross-compilation patch from Bo Thorsen--moves -lX11 to LIBS [vanRijn]
96 version 0.8.3 --
98   - changing external app launch order--we go bbconf, bbkeysconf,
99     bbkeysConfigGtk, rxvt, xterm... *phew*
101   - fix in stackmenu.cc (hopefully we got it this time?) to fix segfaults
102     on some platforms due to screwy X stuff. *shudder*
105 version 0.8.2 --
107   - patched for matrix-style workspace navigation, updating the 0.3.5 patch written
108     by Markus Ottenbacher (m.ottenbacher@gmx.de) found at
109     http://homepages.compuserve.de/meottenbacher/.  Include UpWorkspace,
110     DownWorkspace, LeftWorkspace and RightWorkspace as WithAction() in your
111     ~/.bbkeysrc, and enable the arrangement in rows and columns in your
112     bbkeys.bb as well as in bbpager.bb (usually placed under
113     /usr/local/share/bbtools/) to use this functionality.  Bill Beal <beal@tunl.duke.edu>
115   - fixed a bug due to an improper test for next and prev (test for key
116     release).  next and prev might just be 0, so we can't do if (next)
117     because the correct index of the grabSet.KeyMap might be 0 for either
118     prevwindow or nextwindow keybinding and it would fail the test and not
119     release the keyboard and not lower the window menu.
121   - fixed a bug for the window list popup menu--sticky window bug where
122     sticky windows would show up twice on their originating windows but not
123     at all on the workspace that you switched from immediately prior to
124     switching to the window where the sticky window is "homed"...  =:)
126   - xOr's new "showAllWorkspaces" option lets you see every window that you
127     have on any workspace with an indicator as to what workspace that
128     window is living on....  Very sweet code.
130   - fix for popup window menu...  Added "always on top" code so that it
131     stays at top of window stack and won't let blackbox hide it with any
132     other window (as occurs when auto-raise is enabled in blackbox).
134 version 0.8.1 --
135   - bug fixin's--fixed annoying "un-iconify" feature when bbkeys did window
136     cycling, thanks to halt, all else for pointing that one out....  Also,
137     removed REPORT struct from resource.hh which only had auto_raise in it
138     (not sure why it's been there, un-used all this time anyway)....
140   - changed all "friend .*$" to "friend class .*$" to comply with more
141     strict gcc versions....  Thanks to Jan Schaumann for this!
143   - okay. stacked window cycling tweaks.  As a visual clue for the
144     stacked-Cycling folks, we now set focus on cycled-through windows as we
145     go, raising the window selected at the end of the cycle.  This sounds
146     more confusing than it is.   This makes it possible to separate the new
147     and improved cycling method from the popup menu. Oh, and hitting Escape 
148     in the middle of cycling will return focus to the window that you 
149     started from....
151   - I've made it possible to turn off the visual menu for the new-and-improved
152     stacked cycling method.  To do this, just put 
153     "bbkeys.menu.showCycleMenu: False" (without the quotes, duh) into your
154     ~/.bbtools/bbkeys.bb or ~/.bbtools/bbkeys.nobb file.  This will let
155     bbkeys still use the new method, will set focus as you cycle through the
156     stack, but won't actually raise the window you want until you tell it
157     to by releasing your keys or hitting <Enter>, and won't show the popup
158     window list and cycle through the entries as you go.  Again, harder to
159     explain than it is to use....
161   - including README, ChangeLog, and AUTHORS in installed files list
163   - including first man page files (W00T!!)  =:).  Thanks to Jan Schaumann,
164     bbkeys now has man pages, baybee.  Installing now and including files
165     in bbkeys.spec
167 version 0.8.0 --
168   - BIG changes!!!  w00T!!!  There's some very significant improvements in
169     this version, and as such, I'm calling this version 0.8.0 for various
170     reasons....
171       1) I feel like it
172       2) I'm thinking we're about "there", and 0.8.0 sounds like more of a
173       non-beta product than 0.3.8
174       3) I feel like it   =:)
176   - xOr (see below) has done some majorly good coding with bbkeys.  He's
177     implemented a different window-cycling scheme that's more
178     "Windows"-like (think <alt+tab> popup window with list of things you're
179     cycling through)...  Verrrry slick.  Umm. Did I say Verrrrry?  
180     
181     Why, yes I did.  You are just going to have to see it to believe it.  Blackbox
182     has just again become my favorite window manager for X, with the help
183     xOr has given to me.  The window cycling methodology has changed, and
184     believe me, this is a change for the better.  There's now two methods
185     of window cycling--both use the same keybindings, so don't get yer
186     panties tied in knots.  xOr has implemented a newer, better "old-style"
187     window cycling, called linear cycling.  It's basically what
188     blackbox/bbkeys has done up until this point, but with a few
189     significant improvements.  But the really exciting new feature in this
190     release of bbkeys is the other way--a "stacked" cycling method.  It
191     makes much more sense than the old way.  And it's purtier, because you
192     can see what you're window-changing to before you actually go there.
193     And when you hit <alt+tab> (example keybinding--you can have it be
194     whatever you want it to be), it goes back to the window you were on
195     right before this one.
197     It's way cool, uber-neato, and excellently implemented.  I'll expand on
198     this more in README, so look there for more details.
200   - xOr has also fixed a bug in LinkedList.cc (as posted to the blackbox
201     mailing list) that affected how the windows were put into the cycling
202     stack.
204   - I'm considering xOr a co-developer now (as long as he has the time and
205     desire, of course), but we've a project available on sourceforge.net at
206     http://sourceforge.net/cvs/?group_id=32563 .  Of course, this means
207     that all the usual sourceforge advantages are there, like CVS access,
208     etc.  The project is bbconf.sourceforge.net for the time being, so
209     CVS access looks like this:
211     cvs -d:pserver:anonymous@cvs.bbconf.sourceforge.net:/cvsroot/bbconf login
212     <hit enter for password>
213     cvs -z3 -d:pserver:anonymous@cvs.bbconf.sourceforge.net:/cvsroot/bbconf co bbkeys
215     I've imported the bbkeys tree (0.8.0 will be pulled directly from it),
216     and I've also imported a bbconf module.  bbconf will be the new
217     all-in-one blackbox configuration utility (if I get some help).  =:)
218     To get read-only access to it, do this...
220     cvs -d:pserver:anonymous@cvs.bbconf.sourceforge.net:/cvsroot/bbconf login
221     <hit enter for password>
222     cvs -z3 -d:pserver:anonymous@cvs.bbconf.sourceforge.net:/cvsroot/bbconf co bbconf
224   - adding ToggleDecor as an option to toggle ummmm, window decor.... (duh). 
225     *** BIG HONKING NOTE ***
226     This doesn't currently work.  =:\  The code is in bbkeys, but can't
227     actually do anything until blackbox is changed to tell us what the
228     decorated state of the window is.  Hopefully this will be included in
229     blackbox soon....
231   - changing order of configurator launch again, thanks to a bug report
232     from David Lawrence Ramsey (I had " black" instead of "black")--so we
233     now try rxvt before xterm, and rxvt should actually work now....
235   - hopefully fixing strcasecmp issue for AIX boxen--it's in strings.h
236     instead of string.h.  Adding check for strings.h....  PLEASE let me
237     know if this doesn't actually fix anything.  I'd like to put this guy
238     to bed....
240   - Applying patches from Ben Jansens <xor at x-o-r dot net>.  His comments
241     are below....
243       I've removed all the functionality from the wminterface class that bbkeys
244       does not use, and reorganised the header files for wminterface and bbkeys,
245       adding comments for all of the class members.  With this patch, bbkeys not 
246       longer calls the blackbox cycling routines, but maintains its own list of 
247       windows, and cycles them itself. One thing to note is that the cycling does 
248       not occur in the same order as the buttons on the toolbar cycle. I personally 
249       dont think this will be a big issue, and i think the new way is nicer. When a
250       new window opens, its added to the list right *after* the focused window,
251       so that hitting PrevWindow would take you back to the window that was
252       previously focused.  
254     ....
256     * VERY nice work, Ben.  Thanks for your work! *
258   - Bug squashing and fixing galore...  Thanks again to Ben for pointing
259     these out.  The issue was that we were doing stuff to windows without
260     making sure the window wasn't our root window.  Doh!  So now we make
261     sure 1) we have a focus_window and 2) that focus_window isn't
262     PointerRoot.  Hopefully that will do the trick....
268 version 0.3.6 --
269   - Fixed slight bug in font-loading for label.font and frame.font.  As
270                 things were, we only looked for TitleFont (a bbtools-specific directive
271                 which most probably isn't in most style files), a bbkeys-specific font
272                 directive (which was less likely to be found).  I added to the search
273                 criteria toolbar.font, which for sure will be in every
274                 toolbox/bbconf-generated style file and is most probably in every other
275                 style file as well.  Long story short, fonts should now load according
276                 to the individual style used, rather than relying so heavily on
277                 helvetica....
278         - applied patch submitted from MrFab (Scott Garner for the irc-challenged)
279                 to manipulate window placement via keypress!!!  VERY clean and nice
280                 work, MrFab!!  And useful, to boot!  =:)
281         - reworked and applied patch from Alex (dicerandom @ earthlink dot net)
282                 for keystroke-resizing of focused windows.  Very nice work, Alex!
283                 Thanks!!  =:)
284         - reworked fork() section for configurator launch--based on Kyle
285                 Donaldson's idea....  We now try bbkeysconf, bbkeysConfigGtk, xterm,
286                 rxvt--in that order...  Thanks Kyle!
287         - new and improved bbkeysConfigC--better functioning, disclaimer added
288                 since we trounce on whatever was in ~/.bbkeysrc, added printout of all
289                 available keygrabs now....
291 version 0.3.5 -- 
292   - Doh!!  In the midst of the glorious bug-squashing that 0.3.4 offered, I
293                 introduced a new bug (just to see if anybody actually uses my code,
294                 erm, or something).  =:)  I was getting rid of all the strdups that I
295                 could and in the process forgot to replace it with a working solution
296                 for the ExecCommand part of bbkeys's functionality.  
298 version 0.3.4 --
299   - updated Image.cc, Image.hh, BaseDisplay.hh to newest (0.61.0) blackbox
300           files to correct bug that reared its ugly little head when running on 
301                 SPARC boxen Ultra 5 (Bus Error).  Thanks to Tibor Simko for reporting
302                 this one....
303         - many bug fixes and killing of leaks =:)  thanks to memprof and X
304                 man-page reading (shudder).  I found quite a few memory leaks (some
305                 that bbkeys inherited from the XEmacs code) and discovered some
306                 undocumented features that may not qualify as leaks, but the net result
307                 was that bbkeys could chew up RAM far more than he should.  So, the end
308                 result is that bbkeys now has far fewer memory problems.  I'm pretty
309                 sure that there are more buglets to be found, but that's for when I get
310                 bored again, I guess.  =:)  Thanks to Sean 'Shaleh' Perry for this
311                 buglet report (and others too).  =:)
312         - updated bbkeysconf--couple of fixes for compiling on solaris....
313           - added -lX11 to the link line (should be there anyway)
314                 - changed a QString.left to a QString.at function call 
315                 - thanks to Bo Thorsen for these buglet-reports!  =:)
317 version 0.3.3 --
318   - changes and updates (thanks to nyz for the help!!!) to change the 
319           communication Atoms between blackbox-0.60.1 and bbkeys (READ: YOU MUST
320                 BE RUNNING BBKEYS 3.3 OR LATER IF YOU USE BLACKBOX 0.60.1 OR LATER)...
322 version 0.3.2 --
323   - Weehee!!  Get along, little doggie!!  Or something....  Thanks to the 
324     man, the myth, the legend, the zzzeek-meister, one of those irritating 
325     little problems that I've never had enough interest in fixing has been
326     fixed!!  You know the one--where you're going merrily along through your
327     day, using bbkeys happily, when all of a sudden, things appear to have
328     just stopped working altogether.  And then you start cursing that 
329     darned bbkeys author, and in general, have a horrid day thereafter.  Well
330     fear no more, little pilgrim--that "feature" has been hunted down and 
331     wrestled to the ground, thanks to zzzeek (classic@io.com).  The 'feature'
332     was one that I was never worried about--since it followed blackbox's 
333     'feature' that did exactly the same thing.  What thing is that?  Why,       
334     I'm so glad you asked.  If you hadn't noticed before, if you have your 
335     CapsLock, NumLock, or ShiftLock pressed (or any other funky modifier 
336     key pressed), bbkeys stopped performing your key-grabs.  
338     Well, anywho, I've rambled enough.  I'm going to have bbkeys by default
339     work with any modifiers now.  If you want bbkeys to work the way it does
340     now and stop grabbing keys when you have Caps/Num/ShiftLock pressed, 
341     you'll have to change this line to True in your bbkeys config file 
342     ($HOME/bbtools/bbkeys.bb, not ~/.bbkeysrc):
344     bbkeys.honorModifiers:        False
346   
347 version 0.3.1 --
348   - *sigh* My next release is going to not even have a UI.  =:)  Okay, for 
349     those in this world who run blackbox on a 12" monitor (*cough* talmage
350     *cough*), or refuse to upgrade because -miniMe is toooooo big (*cough*
351     luqin *cough), =:)  bbkeys now has a new run-time switch "-tinyMe" which
352     will cause bbkeys to draw itself at the old 0.2.7 size.  
354   
355 version 0.3.0 --
356   - buglet fix in MakeWindow so we don't XMapWindow every time (thanks nyz!)
357   - alrighty then, the -miniMe controversy continues.  kns mentioned an idea
358     for a new miniMe look and I like it.  _I_ may even use -miniMe now.
359     =:)  Here's the thing, I really don't care at all about -miniMe, since
360     I use him at full-size.  If somebody wants to code for this to be a 
361     configurable option (bbkeys.keyhole.size or bbkeys.keyhole.width, etc.),
362     I'll be more than happy to look at it. 
364   
365 version 0.2.8 --
366   - included new Image classes from the latest blackbox source so luqin's 
367     and r00tv's styles work.  =:)  Oh, it'll help other people too, but 
368     they pested me first.
369   - added Workspace9, 10, 11, and 12 to keygrabs and configurator
371   
372 version 0.2.7 --
374   - added MaximizeVertical and MaximizeHorizontal key-grabbability.  Don't 
375     know why it didn't occur to me earlier.  =:)  nyz did all the hard work
376     4 releases ago.
378   - As of this release of bbkeys, I'm no longer going to support the gtk
379     configurator (unless I get a WHOLE lot of of input to the contrary). 
380     I've re-written the gui configurator in qt (thanks to luqin for the 
381     beginnings of this) and let me tell you, it is a WHOLE lot easier to 
382     work with qt2 than gtk.  Much, much cleaner.  You doubt?  
384           (gideon@judea)[bbkeysConfigGtk/src]-% wc -l *.{c,h}   
385               538 bbkeysConfig.c
386               689 bbkeysConfigSig.c
387               158 support.c
388                 7 bbkeysConfig.h
389               139 bbkeysConfigSig.h
390                57 support.h
391              1588 total
393           (gideon@judea)[bbkeys-0.2.7/bbkeysconf-1.1]-% wc -l *.{cc,hh}
394               593 gui.cc
395                24 main.cc
396                27 myapplication.cc
397                67 gui.hh
398                23 myapplication.hh
399               734 total
401     734 lines of code versus 1588 makes me a happy, happy SE.  =:)
403   - So, I'm pulling out the bbkeysConfigGtk directory from the bbkeys source
404     tarball and in its place is bbkeysconf.  I'll also be regulaly 
405     posting rpms of both bbkeys and bbkeysconf as new releases rear their
406     ugly little heads, as well as one last RPM of bbkeysConfigGtk as well
407     as the tarball for bbkeysConfigGtk if anybody just HAS to have the gtk
408     version.  =:)
410   - As a result of this, the -no[gtk] for bbkeys will change to -no[qt].
411   
412   - Slight buglet fix for bbkeys when he's in iconic mode to properly set 
413     WM_ICON_NAME (Thanks to Mats Jonson for the bug-report.  =:) ) so bbkeys
414     shows up as bbkeys and not "Unnamed" in blackbox's Icon list.  
417   
418 version 0.2.6 --
419   - Weehee!!!  Much bug-squashing release!!!
420   - added ability for bbkeys to minimize itself (right-click on bbkeys's
421     "close" button).  This should satisfy those of us who would like to not
422     see the beautiful little application I wrote and just use it.  *sniff*  =:)
423   - added "-iconic" switch, so bbkeys can be launched in minimized mode.
424     Again, *sniff*  Nobody likes my pretty window.  =:)
425   - fixed a few undocumented features...
426     -- bbkeys queued up all keystroke combos while external gooey configurator 
427        was running and then did then all at once, really quick-like when you
428        came back from the configurator.  This tended to annoy my users.  =:)
429     -- bbkeys wasn't releasing grabbed keys before it launched the
430        configurator, so the configurator wasn't receiving any of the previously
431        grabbed keys. XSync(False) does wonders.  =:)
432   - updated bbkeysConfigGtk to allow configuration of ExecCommand directives.
434   
435 version 0.2.5 --
436   - erm.  forgot to write in this for a while. =:)
437   - took out timer implementation for ~/.bbkeysrc changing -- this should fix
438     the abnormally high CPU/MEM usage that bbkeys has shown -- and replaced it
439     with a virtual function call to CheckConfig out of BaseDisplay.cc.
440   - thought about changing the configurators, then changed my mind.  =:\
442   
443 version 0.2.3 --
444   - fix for bbkeys not pickup up anything for its frame color/texture
445     (thanks to luqin for the patch. =:) )
447   
448 version 0.2.2 --
449   - added ExecCommand feature so users can define programs to execute with
450     a given keystroke. Syntax is as follows: 
452     KeyToGrab(F1), WithModifier(Mod1), WithAction(ExecCommand), DoThis(PROGRAM)
454     where PROGRAM is whatever you want to launch.  PROGRAM must be in your PATH
455     if it is not given with a path. (duh) =:)
457   - improved the logic (hopefully) surrounding resource loading.  Took 
458     loadKeygrabs out of reconfigure() (which gets hit on every Expose event)
459     which should improve bbkeys's performance.  Also, apparently I've never 
460     put in the code that I thought I did which checks ~/.bbkeysrc for changes.
461     That should work correctly now.
464   
465 version 0.2.1 -- 
466   - fixed several style issues.  
468   - fixed the bug with having two "-n" switches. =:)  now, "-no[gtk]" is the
469     way to tell bbkeys to launch the xterm-based conflagurator
471   - re-coded bbkeys' internals (made them much more intuitive and easy to read).
472     bbkeys uses 3 basic objects: Window's, GEOM(etry objects), and Pixmap 
473     objects. The Windows are physical units of space that X communicates with.
474     The GEOM objects are pretty self-explanatory, x, y, height, width.  And
475     the Pixmap objects contain the image that is mapped onto the window itself.
476     It goes like this:
477     ----------------------------------------------------------------------------
478     Windows:      GEOMs:         Pixmaps:           resource->objects and what  
479                                                 resources bbkeys uses for them
480     ----------------------------------------------------------------------------
481     win_title     geom_title     pix_title             label.texture
482                                                           window.label.focus 
483     win_back      geom_back      pix_back              frame.texture
484                                                           window.title.focus
485     win_closeBtn  geom_closeBtn  pix_closeBtn          button.texture
486                                                           window.button.focus
487     win_configBtn geom_configBtn pix_configBtn         button.texture 
488                                                           window.button.focus
489                                  pix_pressedBtn        button.texture_pressed
490                                                           window.button.pressed
491     ----------------------------------------------------------------------------
492      
493   - fixed style files in data/ (silly me, I forgot to change them over from 
494     bbpager's style files. )  Extra-special thanks to sourceo for pointing 
495     this little bit to me and reminding me to put it in the ChangeLog =:)
497   
498 version 0.2.0 -- 
499   - got rid of all the old bbws code base from bbkeys and ported the whole 
500     darned thing to kns's bbpager-0.2.5-alpha code base.
502   
503 version 0.1.4 --
505   - added "-mini-Me" switch =:) for those people *cough* sissies *cough* who
506     complain about bbkeys' size.  So size DOES matter.... erm, anyway, if 
507     launched with the "-mini-Me" option, bbkeys will draw a cute little window
508     10x10 in size (or whatever I feel like, dangit) containing just the button
509     to launch the configurator, instead of the regular, full-blown window.  No 
510     exit button for YOU!  =:)  Let me know if this doesn't suit you....
512   - improved documentation of sorts.  Ugly habit, this documentation stuff. If
513     you look in README, you'll now see all of the commands that bbkeys will
514     think about obeying. If it feels like it.  And if you ask really, really
515     nicely.