@node Usage, Customization, Installation, Top
@comment  node-name,  next,  previous,  up
@chapter Usage

@c This section describes the hard-coded mouse and keyboard bindings.

Note that WindowMaker, like NEXTSTEP(tm) has 2 types of "icons":

@enumerate
@item The Miniwindow
This is the icon as you know it from other window managers such as Fvwm or AfterStep for
example
@item The Application Icon
Representing an applications instance
@end enumerate

@menu
* Operations on Windows::       
* Working with the Dock::       
* Window Instance and Class Information::  
@end menu

@node Operations on Windows, Working with the Dock, Usage, Usage
@comment  node-name,  next,  previous,  up
@section Operations on Windows

@menu
* Resize::                      
* Shade::                       
* Raise and Lower::             
* Focus and Hide::              
* Move::                        
* Close::                       
* Select::                      
@end menu

@node Resize, Shade, Operations on Windows, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Resize

@itemize @bullet
@item Hitting @kbd{Shift} during window resizes/moves, change the type of geometry display.
@item @kbd{Control-Double-Click} in @b{titlebar} maximizes window vertically
@item @kbd{Control-Shift-Double-click} in @b{titlebar} maximizes window in all sides
@item @kbd{Click-Drag} on the @b{resize handle corners} resize the window both
horizontally and vertically.
@item @kbd{Click} near the @b{outer part of the corners} will resize only horizontally
@item @kbd{click} in the @b{part between the corners} will resize only vertically.
@end itemize


@node Shade, Raise and Lower, Resize, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Shade

Shade is a window function that makes a window disappear except for the title bar.  This
is useful for saving desktop space.  Allegedly, some people prefer this over iconification.

@itemize @bullet
@item @kbd{Double-Click} on @b{titlebar} shades the window.
@end itemize


@node Raise and Lower, Focus and Hide, Shade, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Raise and Lower

@itemize @bullet
@item @kbd{Single-Click} on the @b{titlebar} of the window and @b{menus} raises them.  
@item @kbd{Meta-Click} on @b{window} and @b{menu titlebar} lowers them.
@item @kbd{Meta-Click} @b{inside a window} moves or raises the window
@end itemize


@node Focus and Hide, Move, Raise and Lower, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Focus and Hide

@itemize @bullet
@item @kbd{Button2} on @b{titlebar} or @b{window} focuses the window without changing the
stacking order.
@item @kbd{Meta-Click} on @b{iconify button} will Hide the application (only apps that have a application icon)
@item @kbd{Meta-Double-Click3} on window @b{titlebar} hides all windows not focused
@item @kbd{Double-Click} on @b{application icon} (not miniwindow) will activate the
application and bring it to the front. If it is on another workspace it will be brought to
the current workspace.

@end itemize

@node Move, Close, Focus and Hide, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Move

@itemize @bullet
@item @kbd{Meta-Click} on @b{handle} moves the window, instead of resize.
@end itemize

@node Close, Select, Move, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Close

@itemize @bullet
@item @kbd{Double-Click} on @b{broken close button} kills the client
@item @kbd{Control Click} in a @b{close button} kills the client
@end itemize

@node Select,  , Close, Operations on Windows
@comment  node-name,  next,  previous,  up
@subsection Select

Selecting Windows serves the purpose of moving windows together.  If you switch workspaces
while windows are selected, their workspaces will be changed too.

@itemize @bullet
@item @kbd{Shift-Click-1} or @kbd{Shift-Click-2}, on @b{titlebar} selects or deselects the window
@item @kbd{Double-Click} with button2 in titlebar selects the window
@item @kbd{Click-Drag} on @b{root window} selects windows.
@end itemize



@node Working with the Dock, Window Instance and Class Information, Operations on Windows, Usage
@comment  node-name,  next,  previous,  up
@section Working with the @dfn{Dock}

@table @asis
@item @b{Adding an Application Icon} 
Drag an Application Icon in the empty space below the Dock so that it is added to it.  If
the Application provides enough information so that it can effectively be docke, you will
see a white square flashing below the aerea of the Dock where the Application Icon would
reside.
@item @b{Removing an Application Icon}
Drag an Application Icon out of the Dock to dettach it or remove the button, depending
whether the application is running or not.
@end table

@subsection Key Bindings

@itemize @bullet
@item @kbd{Double-Click} on a @b{docked icon with 3dots} will launch the application
@item @kbd{Double-Click} on a @b{docked icon} @emph{without the 3dots} will activate the application
@item @kbd{Meta-Double-Click} on the @b{first Dock icon} disables/enables wether the Dock
remains on Top or not.
@item @kbd{Meta-Double-Click} on a @b{docked icon} @emph{without the 3dots} will launch the application
@end itemize


@node Window Instance and Class Information,  , Working with the Dock, Usage
@comment  node-name,  next,  previous,  up
@section Window Instance or Class Information

@kbd{Right-Double-Click} on an @b{icon} or @b{window titlebar} outputs the instance and
class information about the window to the terminal. Use this to associate an icon with
that window in @file{app_options}.

@c Additional keyboard bindings are defined in Library/WindowMaker/preferences


