blackbox man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]

blackbox(1)					      blackbox(1)

NAME
       blackbox - a window manager for X11

SYNOPSIS
       blackbox -help | -version
       blackbox [ -rc rcfile ] [ -display display ]

DESCRIPTION
       Blackbox is a window manager for the Open Group's X Window
       System, Version 11 Release 6 and	 above.	  Its  design  is
       meant to be visually minimalist and fast.

       Blackbox is similar to the NeXT interface and Windowmaker.
       Applications are launched using a menu which  is	 accessed
       by right clicking on the root window. Workspaces, a system
       of virtual desktops are controlled via  a  menu	which  is
       accessed	 by  middle  clicking  on  the root window and by
       using the toolbar. Individual windows can be controlled by
       buttons on the title bar and more options are available by
       right clicking on the title bar.

       Blackbox is able to generate beautiful window  decorations
       on  the fly at high speed. Themes, called styles in Black
       box terminology, are very flexible but the use of  pixmaps
       has  been  purposefully	avoided to eliminate dependencies
       and excess memory usage.

       Blackbox itself does not directly handle key bindings like
       most other window managers. This task is handled by a sep
       arate utility  called  bbkeys.  Although	 Blackbox  has	a
       built-in	 workspace  (paging)  system, bbpager, which pro
       vides a graphical  pager,  is  popular  with  many  users.
       bbkeys,	bbpager and several other bbtools can be found by
       going to

	    http://bbtools.thelinuxcommunity.org/

       The slit is an edge of the screen which can hold specially
       designed	 programs called dock apps (from Windowmaker). In
       addition, the popular program gkrellm will also run in the
       slit.  There is a huge selection of dockapps available and
       they run the gamut from must-have gadgets to utterly  use
       less (but cute and/or funny) eye candy.

	    http://www.bensinclair.com/dockapp/
	    http://dockapps.org/

OPTIONS
       Blackbox supports the following command line options:

       -help  Display command line options, compiled-in features,
	      and exit.

       -version
	      Display version and exit.

       -rc rcfile
	      Use an alternate resource file.

       -display display
	      Start Blackbox on the specified  display,	 and  set
	      the  DISPLAY environment variable to this value for
	      programs started by Blackbox.

STARTING AND EXITING BLACKBOX
       The most common method for starting Blackbox is	to  place
       the  the command "blackbox" (no quotes) at the end of your
       ~/.xinitrc or ~/.xsession file.	The advantage of  putting
       Blackbox	 at the end of the file is that the X Server will
       shutdown when you exit  Blackbox.  Blackbox  can	 also  be
       started	from  the command line of a terminal program like
       xterm in an X session that does not already have a  window
       manager running.

       On  startup,  Blackbox will look for ~/.blackboxrc and use
       the resource session.menuFile to determine  where  to  get
       the  menu  for  the  session.   If  this file is not found
       Blackbox will use @defaultmenu@ as the menu file. If  that
       fails  as  well Blackbox will use a default menu that con
       tains commands to start an xterm as well	 as  restart  and
       exit the window manager.	 The other resources available in
       the ~/.blackboxrc file are discussed later in this  manual
       under the heading RESOURCE FILE.

       On  exit,  Blackbox  writes  its	 current configuration to
       ~/.blackboxrc.

	    NOTE:
	    If ~/.blackboxrc is modified during a Blackbox
	    session, Blackbox must be restarted with the
	    "restart" command on the main menu or the changes
	    will be lost on exit. Restart causes Blackbox to
	    re-read ~/.blackboxrc and apply the changes immediately.

       Blackbox can be exited by selecting  "exit"  on	the  main
       menu  (discussed shortly), killing it gently from a termi
       nal or by the X	Window	System	shutdown  hot  key  combo
       Ctrl+Alt+BackSpace.

USING BLACKBOX
       A  three	 button	 mouse	has  the following functions when
       clicking on the root window:

       Button Two  (Middle Button)
	      Open workspace menu

       Button Three  (Right Button)
	      Open main menu

       Note that Button One (Left Button) is not used.

       Main Menu
	      The default installation assumes you have a  number
	      of common X Window System programs in their typical
	      locations. The default menu is defined by	 a  plain
	      text file named 'menu'. It is heavily commented and
	      covers a number of details  of  menu  file  syntax.
	      This  file  can also be edited graphically by using
	      the extension program bbconf which makes menu  cre
	      ation  very  easy.  Menu	file  syntax is discussed
	      later in this manual.

		   Caveat:
		   Menus can run arbitrary command lines, but
		   if you wish to use a complex command line
		   it is best to place it in a shell script.
		   Remember to put #!/bin/sh on the first
		   line and chmod 755 on the file to make it
		   executable.

       Workspace Menu
	      This menu gives the user control of  the	workspace
	      system. The user can create a new workspace, remove
	      the last workspace or  go	 to  an	 application  via
	      either   the   icon  menu	 or  a	workspace  entry.
	      Workspaces are listed  by	 name.	Clicking  on  the
	      workspace name will take you to that workspace with
	      focus on the program under the mouse. If there  are
	      programs	already	 running  in  the workspace, they
	      will appear in a pop-out	menu.	Clicking  on  the
	      application  name	 will  jump  to the workspace and
	      focus that application. If a middle click	 is  used
	      the   window   will   be	brought	 to  the  current
	      workspace.

	      Blackbox uses an external program, bbpager, to pro
	      vide  a  traditional, graphical paging interface to
	      the  workspace  system.  Many  Blackbox  users  run
	      another  extension  program  -  bbkeys - to provide
	      keyboard shortcuts for workspace control.

		   Caveat:
		   To name a workspace the user must right
		   click on the toolbar, select "Edit current
		   workspace name," type the workspace name,
		   And_Press_Enter to finish.

	      Workspaces can also be  named  in	 the  .blackboxrc
	      file as described in RESOURCES.

       The Slit
	      The  Slit	 provides  a user positionable window for
	      running  utility	programs  called  "dockapps".  To
	      learn  more  about  dockapps refer to the web sites
	      mentioned in the	Description.  Dockapps	automati
	      cally  run  in  the  slit	 in  most  cases, but may
	      require a special command	 switch.   Often,  -w  is
	      used for "withdrawn" into the slit.

	      gkrellm  is  a  very useful and modern dockapp that
	      gives  the  user	near  real  time  information  on
	      machine performance. Other dockapps include clocks,
	      notepads, pagers,	 key  grabbers,	 fishbowls,  fire
	      places and many, many others.

	      Only mouse button three is captured by the Blackbox
	      slit. This menu allows the user to change the posi
	      tion  of	the slit, and sets the state of Always on
	      top, and Auto hide. These	 all  do  what	the  user
	      expects.

		   Caveat:
		   When starting Dockapps from an external script
		   a race condition can take place where the shell
		   rapidly forks all of the dockapps, which then
		   take varied and random times to draw themselves
		   for the first time. To get the dockapps to start
		   in a given order, follow each dockapp with
		   sleep 2; This ensures that each dockapp is placed
		   in the correct order by the slit.

		   i.e.
		   #!/bin/sh
		   speyes -w & sleep 2
		   gkrellm -w & sleep 2

       The Toolbar
	      The   toolbar  provides  an  alternate  method  for
	      cycling through multiple	workspaces  and	 applica
	      tions.   The  left  side	of  the	 toolbar  is  the
	      workspace control, the center  is	 the  application
	      control,	and the right side is a clock. The format
	      of the clock can be controlled as	 described  under
	      RESOURCES.

	      Mouse button 3 raises a menu that allows configura
	      tion of the toolbar. It can be positioned either at
	      the  top or the bottom of the screen and can be set
	      to auto hide and/or to always be on top.

		   Caveat:
		   The toolbar is a permanent fixture. It
		   can only be removed by modifying the source and
		   rebuilding, which is beyond the scope of this
		   document. Setting the toolbar to auto hide is
		   the next best thing.

       Window Decorations
	      Window decorations include handles at the bottom of
	      each  window,  a	title bar, and three control but
	      tons.  The handles at the bottom of the window  are
	      divided  into  three sections.  The two corner sec
	      tions are resizing handles The center section is	a
	      window  moving handle. The bottom center handle and
	      the title bar respond to a number of  mouse  clicks
	      and  key + mouse click combinations. The three but
	      tons in the title bar, left to right, are	 iconify,
	      maximize,	 and close. The resize button has special
	      behavior detailed below.

       Button One  (Left Button)
	      Click and drag on titlebar to move or  resize  from
	      bottom  corners.	 Click the iconify button to move
	      the window to the icon list.   Click  the	 maximize
	      button  to  fully	 maximize  the window.	Click the
	      close button to close the window	and  application.
	      Double-Click the title bar to shade the window.

       Alt + Button One
	      Click  anywhere  on  client window and drag to move
	      the window.

       Button Two  (Middle Button)
	      Click the titlebar to lower the window.  Click  the
	      maximize	button to maximize the window vertically.

       Button Three  (Right Button)
	      Click on title bar or bottom  center  handle  pulls
	      down  a control menu.  Click the maximize button to
	      maximize the window horizontally.

       Alt + Button Three
	      Click anywhere on client window and drag to  resize
	      the window.

       The control menu contains:

       Send To ...

		   Button One  (Left Button)
		   Click to send this window to another workspace.

		   Button Two  (Middle Button)
		   Click to send this window to another workspace, change
		   to that workspace and keep the application focused.
		   as well.

       Shade  This is the same action as Double-Click with Button One.

       Iconify
	      Hide the window.	It can be accessed with the icon menu.

       Maximize
	      Toggle window maximization.

       Raise  Bring window to the front above the other windows and
	      focus it.

       Lower  Drop the window below the other ones.

       Stick  Stick this window to the glass on the inside of
	      the monitor so it does not hide when you change
	      workspaces.

       Kill Client
	      This kills the client program with -SIGKILL (-9)
	      Only use this as a last resort.

       Close  Send a close signal to the client application.

STYLES
       Styles  are  a  collection  of colors, fonts, and textures
       that control the appearance of Blackbox. These  character
       istics  are  recorded  in  style files. The default system
       style files are located in @pkgdatadir@/styles.	The  menu
       system will identify the style by its filename, and styles
       can be sorted into different  directories  at  the  user's
       discretion.

       There  are  over	 700  styles  available for Blackbox. The
       official distribution point for Blackbox styles is

	    http://blackbox.themes.org/

       All themes should install by simply  downloading	 them  to
       ~/.blackbox/ then unzip it, and de-tar it.

       On open Unixes this will be:

       tar zxvf stylename.tar.gz

       On commercial Unixes this will be something like:

       gunzip stylename.tar.gz && tar xvf stylename.tar

       Check your system manuals for specifics or check with your
       network administrator.

       An entry should appear in the styles menu immediately.

	    Security Warning
	    Style files can execute shell scripts and other
	    executables. It would is wise to check the
	    rootCommand in the style file and make sure that
	    it is benign.

       Things that go wrong.

       1. The theme is pre Blackbox 0.51.
	      Style file syntax changed with version 0.51

       2. The style tarball was formatted incorrectly.
	      Some styles use the  directories	~/.blackbox/Back
	      grounds and ~/.blackbox/Styles

	      This  can	 fixed by adding a [stylemenu] (~/.black
	      box/Styles) to your menu file.  To  be  a	 complete
	      purist,  hack the style file with the correct paths
	      and move the files into the correct directories

       3. The rootCommmand line is broken.
	      The rootCommand line in the style file will run  an
	      arbitrary	 executable.  It  is  important that this
	      executable be set to bsetbg to maintain portability
	      between  systems	with different graphics software.
	      In addition bsetbg can execute a shell  script  and
	      do it in a portable fashion as well.

       The documented method for creating styles is as follows:

       1. Create or acquire the background for the style if
	      it  will	not be using bsetroot to draw a patterned
	      background for the root window.

		   NOTE:
		   Blackbox runs on a wide variety
		   of systems ranging from PCs with 640x480 256 color
		   displays to ultra high speed workstations with 25"
		   screens and extreme resolution. For best results a
		   style graphic should be at least 1024x768.

       2. Create a style file.
	      The best way to do this is to make a copy of a sim
	      ilar style and then edit it.

	      The  style  file is a list of X resources and other
	      external variables.  Manipulating	 these	variables
	      allows users to completely change the appearance of
	      Blackbox. The user can also change the root  window
	      image by using the wrapper program bsetbg.

	      bsetbg knows how to use a number of programs to set
	      the root window image. This makes styles much  more
	      portable	since  various	platforms  have different
	      graphics software. For more info see bsetbg (1).

       3. Background images should be placed in
	      ~/.blackbox/backgrounds The style	 file  should  be
	      placed  in ~/.blackbox/styles any other information
	      about the	 style	should	be  placed  in	~/.black
	      box/about/STYLE_NAME/.   This  would include README
	      files, licenses, etc.

	      Previous versions of Blackbox put	 backgrounds  and
	      styles  in  different  directories. The directories
	      listed above  are	 the  only  officially	supported
	      directories.   However  you  may put them whereever
	      you like as long as you update your menu file so it
	      knows where to find your styles.

       4. To create a consistent experience and to ensure
	      portability  between all systems it is important to
	      use the  following  format  to  create  your  style
	      archive.

	      first create a new directory named after your style
	      NEW_STYLE

	      In this directory create the directories

		   backgrounds
		   styles
		   about/NEW_STYLE

	      Next put everything for the theme	 in  these  loca
	      tions. Finally type

	      tar cvzf NEW_STYLE.tar.gz *

	      If  you  are  using commercial Unix you may need to
	      use gzip and tar separately.

	      Now when a user downloads	 a  new	 style	file  she
	      knows  that all she has to do is put the tarball in
	      her Blackbox directory, unzip->un-tar it	and  then
	      click on it in her style menu.

       Style File Syntax and Details

	      By  far the easiest way to create a new style is to
	      use bbconf. bbconf allows complete control of every
	      facet of style files and gives immediate updates of
	      the current style as changes are made.

	      The style file format is not  currently  documented
	      in a man page.  There is a readme document included
	      with the Blackbox source containing  this	 informa
	      tion.

MENU FILE
       The default menu file is installed in @defaultmenu@.  This
       menu can be customized as a system  default  menu  or  the
       user can create a personal menu.

       To  create a personal menu copy the default menu to a file
       in your home directory.	Then, open ~/.blackboxrc and  add
       or modify the resource session.menuFile:	 ~/.blackbox/menu

       Next, edit the new menu file. This can be  done	during	a
       Blackbox	 session  and  the  menu  will	automatically  be
       updated when the code checks for file changes.

       The default menu included with Blackbox has numerous  com
       ments  describing  the use of all menu commands. Menu com
       mands follow this general form:

       [command]  (label|filename) {shell command|filename}

       Blackbox menu commands:

	  #    string...
	      Hash (or pound or number sign) is used as the  com
	      ment  delimiter. It can be used as a full line com
	      ment or as an end of line	 comment  after	 a  valid
	      command statement.

       [begin]	(string)
	      This  tag is used only once at the beginning of the
	      menu file. "string" is the name or description used
	      at the top of the menu.

       [end]
	      This tag is used at the end of the menu file and at
	      the end of a submenu block.

       [exec]  (label string) {command string}
	      This is a very flexible tag that allows the user to
	      run  an  arbitrary  shell	 command  including shell
	      scripts. If a command is too large to type  on  the
	      command  line  by	 hand  it  is best to put it in a
	      shell script.

       [nop]  (label string)
	      This tag is used to put  a  divider  in  the  menu.
	      label string is an optional description.

       [submenu]  (submenu name) {title string}
	      This  creates a sub-menu with the name submenu name
	      and if given, the string title string will  be  the
	      title of the pop up menu itself.

       [include]  (filename)
	      This command inserts filename into the menu file at
	      the point at which it is called.	 filename  should
	      not  contain  a begin end pair. This feature can be
	      used to include the system menu or include a  piece
	      of menu that is updated by a separate program.

       [stylesdir]  (description) (path)
	      Causes  Blackbox	to  search  path for style files.
	      Blackbox lists styles in the  menu  by  their  file
	      name as returned by the OS.

       [stylesmenu]  (description) {path}
	      This  command  creates  a	 submenu  with	the  name
	      description with the contents of path.  By creating
	      a	 submenu  and  then populating it with stylesmenu
	      entries the user can create an organized library of
	      styles.

       [workspaces]  (description)
	      Inserts  a link into the main menu to the workspace
	      menu. If used, description is an optional	 descrip
	      tion.

       [config]	 (label)
	      This  command causes Blackbox to insert a menu that
	      gives the user control over focus models, dithering
	      and other system preferences.

       [reconfig]  (label) {shell command}
	      The  reconfig command causes Blackbox to reread its
	      configuration  files.   This   does   not	  include
	      ~/.blackboxrc which is only reread when Blackbox is
	      restarted. If shell command  is  included	 Blackbox
	      will  run	 this  command	or  shell  script  before
	      rereading the files. This can  be	 used  to  switch
	      between multiple configurations

       [restart]  (label) {shell command}
	      This  command  is	 actually  an  exit  command that
	      defaults to restarting Blackbox. If provided  shell
	      command  is  run	instead	 of Blackbox. This can be
	      used to change versions of Blackbox. Not	that  you
	      would  ever  want	 to do this but, it could also be
	      used to start a different window manager.

       [exit]  (label)
	      Shuts down Blackbox. If Blackbox is the  last  com
	      mand in your ~/.xinitrc file, this action will also
	      shutdown X.

		   Here is a working example of a menu file:
		   [begin] (MenuName)
		      [exec] (xterm) {xterm -ls -bg black -fg green}
		      [submenu] (X utilities)
			 [exec] (xcalc) {xcalc}
		      [end]
		      [submenu] (styles)
			 [stylesmenu] (built-in styles) {@pkgdatadir@/styles}
			 [stylesmenu] (custom styles) {~/.blackbox/styles}
		      [end]
		      [workspaces] (workspace list)
		      [config] (configure)
		      [reconfig] (config play desktop) {play-config-blackbox}
		      [reconfig] (config work desktop) {work-config-blackbox}
		      [restart] (start Blackbox beta 7) {blackbox-beta7}
		      [restart] (start Blackbox cvs) {blackbox-cvs}
		      [restart] (restart)
		      [exit] (exit)
		   [end]

RESOURCE FILE
       $HOME/.blackboxrc  These	 options  are	stored	 in   the
       ~/.blackboxrc  file.   They  control  various  features of
       Blackbox and most can be set from menus. Some of these can
       only be set by editing .blackboxrc directly.

       NOTE:  Blackbox	only  reads this file during start up. To
       make changes take effect during	a  Blackbox  session  the
       user  must  choose  "restart" on the main menu.	If you do
       not do so, your changes will be lost when Blackbox  exits.

       Some  resources	are named with a <num> after screen. This
       should be replaced with the number of the screen	 that  is
       being configured. The default is 0 (zero).

       Menu Configurable  (Slit Menu):
	  Right click (button 3) on the slit border.

       session.screen<num>.slit.placement  SEE BELOW
	  Determines  the position of the slit.	 Certain combina
	  tions of slit.placement  with	 slit.direction	 are  not
	  terribly useful, i.e. TopCenter with Vertical direction
	  puts the slit through the middle of your  screen.  Cer
	  tainly  some will think that is cool if only to be dif
	  ferent...

	       Default is CenterLeft.
	       [  TopLeft  |   TopCenter  |   TopRight	|
		CenterLeft |		  | CenterRight |
		BottomLeft | BottomCenter | BottomRight ]

       session.screen<num>.slit.direction  [Horizontal|Vertical]
	  Determines the direction of the slit.

	       Default is Vertical.

       session.screen<num>.slit.onTop  [True|False]
	  Determines whether the slit is always visible over win
	  dows or if the focused window can hide the slit.

	       Default is True.

       session.screen<num>.slit.autoHide  [True|False]
	  Determines whether the slit hides when not in use.  The
	  session.autoRaiseDelay time  determines  how	long  you
	  must	hover  to  get	the slit to raise and how long it
	  stays visible after mouse out.

	       Default is False.

       Menu Configurable  (Main Menu):

       session.screen<num>.focusModel  SEE BELOW
	  Sloppy focus (mouse focus) is the conventional X Window
	  behavior  and	 can be modified with AutoRaise or Click-
	  Raise.

	  AutoRaise causes  the	 window	 to  automatically  raise
	  after session.autoRaiseDelay milliseconds.

	  ClickRaise causes the window to raise if you click any
	  where inside the client area of the window.

	  Sloppy focus alone requires a click  on  the	titlebar,
	  border or lower grip to raise the window.

	  ClickToFocus	requires a click on a Blackbox decoration
	  or in the client area to focus and  raise  the  window.
	  ClickToFocus	cannot be modified by AutoRaise or Click
	  Raise.

	       Default is SloppyFocus
	       [SloppyFocus [[AutoRaise & ClickRaise]  |
			     [AutoRaise | ClickRaise]] |
	       ClickToFocus]

       session.screen<num>.windowPlacement  SEE BELOW
	  RowSmartPlacement tries to fit  new  windows	in  empty
	  space	 by  making  rows.   Direction	depends	 on  ses
	  sion.screen<num>.rowPlacementDirection

	  ColSmartPlacement tries to fit  new  windows	in  empty
	  space	 by  making  columns  Direction	 depends  on ses
	  sion.screen<num>.colPlacementDirection

	  CascadePlacement places the new window down and to  the
	  right of the most recently created window.

	       Default is RowSmartPlacement.
	       [RowSmartPlacement | ColSmartPlacement | CascadePlacement]

       session.screen<num>.rowPlacementDirection	   [Left_
       ToRight|RightToLeft]
	  Determines placement direction for new windows.

	       Default is LeftToRight.

       session.screen<num>.colPlacementDirection       [TopToBot_
       tom|BottomToTop]
	  Determines placement direction for new windows.

	       Default is TopToBottom.

       session.imageDither  [True|False]
	  This	setting	 is  only  used when running in low color
	  modes. Image Dithering helps to show an image	 properly
	  even	if  there  are not enough colors available in the
	  system.

	       Default is False.

       session.opaqueMove  [True|False]
	  Determines whether the window's contents are	drawn  as
	  it  is moved.	 When False the behavior is to draw a box
	  representing the window.

	       Default is False.

       session.screen<num>.fullMaximization  [True|False]
	  Determines if the maximize button will cause an  appli
	  cation to maximize over the slit and toolbar.

	       Default is False.

       session.screen<num>.focusNewWindows  [True|False]
	  Determines  if  newly	 created  windows are given focus
	  after they initially draw themselves.

	       Default is False.

       session.screen<num>.focusLastWindow  [True|False]
	  This	is  actually  "when  moving  between  workspaces,
	  remember   which   window  has  focus	 when  leaving	a
	  workspace and return the focus to that  window  when	I
	  return to that workspace."

	       Default is False.

       session.screen<num>.disableBindingsWithScrollLock
       [True|False]
	  When	this  resource is enabled, turning on scroll lock
	  keeps Blackbox from grabbing the Alt and Ctrl keys that
	  it  normally	uses  for  mouse  controls.  This feature
	  allows users of drawing and modeling programs which use
	  keystrokes  to  modify  mouse actions to maintain their
	  sanity.  *NOTE* this has _no_ affect on bbkeys.  If you
	  need	bbkeys	to  also behave this way it has a similar
	  option in its config file.  Refer to the bbkeys manpage
	  for details.

	       Default is False.

       Menu Configurable  (Workspace Menu):
	  Middle  click	 (button 2) on the root window (AKA Desk
	  top) to reach this menu

       session.screen<num>.workspaces  [integer]
	  Workspaces may be created or deleted by middle clicking
	  on  the desktop and choosing "New Workspace" or "Remove
	  Last". After creating a workspace, right click  on  the
	  toolbar to name it.

	       Default is 1

       Menu Configurable  (Toolbar Menu):

       session.screen<num>.workspaceNames   [string[, string...]]
	  Workspaces  are  named  in  the order specified in this
	  resource. Names should be delimited by commas. If there
	  are  more  workspaces	 than  explicit	 names,	 un-named
	  workspaces will be named as "Workspace [number]".

	       Default is
	       Workspace 1.

       session.screen<num>.toolbar.placement  SEE BELOW
	  Set toolbar screen position.

	       Default is BottomCenter
	       [  TopLeft  |   TopCenter  |   TopRight	|
		BottomLeft | BottomCenter | BottomRight ]

       session.screen<num>.toolbar.onTop  [True|False]
	  Determines whether the toolbar is always  visible  over
	  windows  or if the focused window can hide the toolbar.

	       Default is True.

       session.screen<num>.toolbar.autoHide  [True|False]
	  Determines whether the toolbar hides when not	 in  use.
	  The session.autoRaiseDelay time determines how long you
	  must hover to get the toolbar to raise, and how long it
	  stays visible after mouse out.

	       Default is False.

       Configurable in	~/.Blackboxrc only:

       session.screen<num>.toolbar.widthPercent	 [1-100]
	  Percentage  of  screen  used	by the toolbar.	 A number
	  from 1-100 that sets	the  width  of	the  toolbar.	0
	  (zero) does not cause the toolbar to disappear, instead
	  the toolbar is set to the default. If you want to  lose
	  the toolbar there are patches that can remove it.

	       Default is 66.

       session.screen<num>.strftimeFormat  [string]
	  A  C	language  date	format string, any combination of
	  specifiers can be used. The default is %I:%M	%p  which
	  generates  a	12  hour  clock with minutes and an am/pm
	  indicator appropriate to the locale.

	       24 hours and minutes    %H:%M
	       12 hours and minute     %I:%M %p
	       month/day/year	       %m/%d/%y
	       day/month/year	       %d/%m/%y

	       Default is hours:minutes am/pm
	       See
	       strftime 3
	       for more details.

       session.screen<num>.dateFormat  [American|European]
	  NOTE: Only used  if  the  strftime()	function  is  not
	  available on	your system.

	       Default is American, (mon/day/year).

       session.screen<num>.clockFormat	[12/24]
	  NOTE:	 Only  used  if	 the  strftime()  function is not
	  available on your system.

	       Default is 12-hour format.

       session.screen<num>.edgeSnapThreshold  [integer]
	  When set to 0 this turns off edge snap. When set to one
	  or  greater edge snap will cause a window that is being
	  moved to snap to the nearest screen edge, the slit,  or
	  or  the  toolbar.  Windows will not snap to each other.
	  The value represents a number in pixels  which  is  the
	  distance  between the window and a screen edge which is
	  required before the window is	 snapped  to  the  screen
	  edge.	  If you prefer this functionality values between
	  6 - 10 work nicely.

	       Default value is 0

       session.menuFile	 [filepath]
	  Full path to the current menu file.

	       Default is @defaultmenu@

       session.colorsPerChannel	 [2-6]
	  The number of colors taken from the X server for use on
	  pseudo  color displays. This value must be set to 4 for

	  8 bit displays.

	       Default is 4.

       session.doubleClickInterval  [integer]
	  This is the maximum time that Blackbox will wait  after
	  one click to catch a double click. This only applies to
	  Blackbox actions, such as double click shading, not  to
	  the X server in general.

	       Default is 250 milliseconds.

       session.autoRaiseDelay  [integer]
	  This	is  the	 time in milliseconds used for auto raise
	  and auto hide behaviors. More than  about  1000  ms  is
	  likely useless.

	       Default is 250 millisecond.

       session.cacheLife  [integer]
	  Determines  the  maximum  number  of minutes that the X
	  server will cache unused decorations.

	       Default is 5 minutes

       session.cacheMax	 [integer]
	  Determines how many kilobytes that  Blackbox	may  take
	  from	the  X server for storing decorations. Increasing
	  this number may enhance your performance  if	you  have
	  plenty of memory and use lots of different windows.

	       Default is 200 Kilobytes

ENVIRONMENT
       HOME   Blackbox uses $HOME to find its .blackboxrc rc file
	      and its .blackbox directory  for	menus  and  style
	      directories.

       DISPLAY
	      If  a display is not specified on the command line,
	      Blackbox will use the value of $DISPLAY.

FILES
       blackbox
	      Application binary

       ~/.blackboxrc
	      User's startup and resource file.

       @defaultmenu@
	      Default system wide menu

WEB SITES
       General info website:
	    http://blackboxwm.sourceforge.net/

       Development website:
	    http://sourceforge.net/projects/blackboxwm/

BUGS
       If you think you have found a bug, please help by going to
       the  development	 website  and  select "Bugs" in the upper
       menu. Check the bug  list  to  see  if  your  problem  has
       already	been  reported. If it has please read the summary
       and add any information that you believe	 would	help.  If
       your  bug  has  not been submitted select "Submit New" and
       fill out the form.

AUTHORS AND HISTORY
       Sean Shaleh Perry    <shaleh@debian.org>	 is  the  current
       maintainer  and	is actively working together with Brad to
       keep Blackbox up-to-date and stable as a rock.

       Brad Hughes  <bhughes@trolltech.com>  originally	 designed
       and  coded  Blackbox in 1997 with the intent of creating a
       memory efficient window manager with  no	 dependencies  on
       external	 libraries.   Brad's  original	idea has become a
       popular alternative to other window managers.

       Jeff Raven  <jraven@psu.edu> then picked up the torch  for
       the  0.61.x  series  after  Brad	 took  a full time job at
       TrollTech.

       This manual page was written by: R.B. Brig Young	 <secret_
       saregood@yahoo.com> he is solely responsible for errors or
       omissions.  Comments,  corrections,  and	 suggestions  are
       welcomed.

SEE ALSO
	    bsetbg(1), bsetroot(1),
	    bbkeys(1), bbconf(1)

0.65.0			September 18, 2002	      blackbox(1)
[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net