
                 bblaunch - an application launcher for blackbox 


bblaunch is an application launcher that lets you set certain blackbox related
attributes on the launched program.  You can use it to run an application with
no decorations, to immediately have it sent to a specific workspace, to have it
visible on all workspaces and so on and so on.

Right now it supports all of the attributes blackbox so kindly allows external
applications to set.  They include:

  Shaded (-s --shaded)
  
    The application is run in the shaded mode. Surprise!

  Horizontal Maximization (-h  --maxhorz)

    The application is run horizontally maximized...it is as wide as your
    desktop but not necessarily as tall.

  Vertical Maximization (-v  --maxvert)

    Same as above, but vertically.

  Omnipresent (-o  --omnipresent)

    That's just fancy blackbox talk for "sticky"--meaning it will appear on all
    workspaces.

  Workspace (-w --workspace <workspace>)

    Allows you the specify which workspace an application with start on.
    <workspace> is an integer between one and your total number of workspaces
    inclusive.

  Stack (-k --stack <stack>)

    Allows you to specify where the application will live in the window stack.
    <stack> is an integer between 0 and 2 inclusive.

    The value meanings are:
      0 - Always on top
      1 - Normal
      2 - Always on bottom
  
    * This attribute is currently not used by blackbox.
      It is here for completeness.

  Decorations (-d --decor <decorations>)

    Allows you to specify the type of window decorations you wish the
    application to possess.  <decor> is an integer between 0 and 3 inclusive.

    The value meanings are:
      0 - No decorations
      1 - Normal decorations
      2 - Tiny decorations
      3 - Tool decorations

    * If those meanings are not clear to you, it is because they are not clear
      to me.  Consult your local blackbox src/ directory for more details...or
      just test them out, it won't kill you.

  Pause (-p --pause <milliseconds>)
    This flag does not affect the window in anyway, but is very important to the
    way bblaunch functions.  It allows you to set the amount of time that
    bblaunch will wait for blackbox to place the new applications window on your
    desktop.  If it is too short, bblaunch may exit before the new window
    appears and none of the options you have specified will take place.  As a
    rule, if bblaunch doesn't seem to be doing what you expect, play with this
    flag.  The default is 1000 (one second).


Well, that's really about it--bblaunch is pretty simple.  If you can't figure it
out, see your doctor immediately as you might be retarded.

Please see LICENSE for license information...obviously.
