nickleby(1)             FreeBSD General Commands Manual            nickleby(1)

NAME
     Nickleby -- Window Manager for X11

SYNOPSIS
     nickleby [-d <display-string> -t <titlebar-color> -b <background-color>]

DESCRIPTION
     Nickleby is a window manager for those of us who live inside xterms, and
     who require no menus or toolbars from our window manager.  It represents
     its author's idea of the simplest window manager that is still useful.

     o   The display to operate upon may be specified with the -d command-line
         option.  Nickleby knows nothing about multiple screens, but it may be
         instructed to operate on a particular screen by specifying the screen
         number as part of the display string.

     o   The -t option changes the background color of title and footer bars.
         The -b option changes the background color of the root window.  The
         values of these options must be expressed in a form the X server
         understands, such as a named color from /usr/local/lib/X11/rgb.txt,
         or a hexadecimal rgb value like, #4e6090.

     o   The keyboard input focus policy is sloppy-focus.

     o   Nickleby uses shading instead of iconification.  Applications which
         run as icons will not display under nickleby.

     o   Nickleby provides one desktop workspace only.

     o   Nickleby does not do "live" moves or resizes to avoid sending a myr-
         iad of resize, move, and expose events to clients not running
         locally, but over the network.

     o   It is not possible to move or resize client windows such that any
         part of them moves offscreen.  The author likes to butt windows up
         against the edges of the screen, and this is a simple matter if win-
         dows stop there.

     o   The only program Nickleby is capable of launching by itself is xterm.

     Window manager functions are bound to input events as follows:

     Mouse clicks over the root window:

         Button          Action
         Button1         circulate windows
         Button2         exit window manager
         Button3         fork an xterm

     Mouse clicks over client window titlebars:

         Button     Action
         Button1    click to raise, drag to move window
         Button2    lower window to bottom of stacking order
         Button3    drag to resize window

     Mouse button1 clicks over titlebar buttons:

         Titlebar Button    Action
         _                  shade/unshade window
         []                 maximize/unmaximize window
         ||                 ask client to close window

     Mouse button3 clicks over titlebar buttons:

         Titlebar Button    Action
         _                  does nothing
         []                 does nothing
         ||                 kill client

     Not all clients participate in the window manager delete window protocol,
     and will therefore not close their windows upon being asked to.  Those
     clients may be killed by clicking the "close" button with mouse button 3.

AUTHORS
     James Bailie <jimmy@mammothcheese.ca>
     http://www.mammothcheese.ca

                                 Oct 05, 2007