Grabs\015\012\015\012{{>toc}}\015\012\015\012Grabs are the button/keyboard mappings in subtle. Every button/keyboard combination can be a grab. \015\012\015\012Genereally there exist three different grabs types:\015\012# Predefined grabs\015\012# Grabs which call a Ruby block\015\012# Grabs that exec a program\015\012\015\012Remember that the config is a complete Ruby file.\015\012\015\012The syntax of the config can be checked with: subtle -k or subtle -k -c /path/to/config\015\012\015\012h3. Chains\015\012\015\012Grab chains are the combination of one or more modifiers and a key/button. The following two lists show the modifier/buttons that are available:\015\012\015\012+Modifier keys+:\015\012* A = Alt key\015\012* C = Control key\015\012* M = Meta key\015\012* S = Shift key\015\012* W = Super (Windows key)\015\012\015\012+Mouse buttons+:\015\012* B1 = Button1 \015\012* B2 = Button2\015\012* B3 = Button3 \015\012* B4 = Button4\015\012* B5 = Button5\015\012\015\012+Example+:\015\012

\015\012"W-F1"    => "xterm -sb"\015\012"S-B1"    => Subtle::Grab::WindowMove\015\012"A-space" => lambda { |c| c.toggle_float }\015\012

\015\012\015\012h2. Predefined\015\012\015\012h3. Views\015\012\015\012Jump to the numbered view.\015\012\015\012* Subtle::Grab::Jump1\015\012* Subtle::Grab::Jump2\015\012* ...\015\012* Subtle::Grab::JumpN\015\012\015\012h3. Windows\015\012\015\012Window grabs manipulate/toggle various properties of client windows.\015\012\015\012* Subtle::Grab::WindowMove\015\012* Subtle::Grab::WindowResize\015\012* Subtle::Grab::WindowFloat\015\012* Subtle::Grab::WindowFull\015\012* Subtle::Grab::WindowStick\015\012* Subtle::Grab::WindowKill\015\012\015\012h3. Gravities\015\012\015\012Gravity grabs manipulate the gravity of the client on the current view.\015\012\015\012* Subtle::Grab::GravityTopLeft\015\012* Subtle::Grab::GravityTop\015\012* Subtle::Grab::GravityTopRight\015\012* Subtle::Grab::GravityLeft\015\012* Subtle::Grab::GravityCenter\015\012* Subtle::Grab::GravityRight\015\012* Subtle::Grab::GravityBottomLeft\015\012* Subtle::Grab::GravityBottom\015\012* Subtle::Grab::GravityBottomRight\015\012\015\012h2. Block\015\012\015\012Grabs can also have a complete "Ruby"::http://www.ruby-lang.org block which has a client as parameter and can access the complete functionality of subtlext.\015\012\015\012+Example+:\015\012

\015\012"S-F1" => lambda { |c|\015\012  v = add_view("test")\015\012\015\012  c + "test"\015\012  v + "test"\015\012\015\012  v.jump\015\012} \015\012

\015\012\015\012h2. Exec\015\012\015\012Invoke a shell and exec program.\015\012\015\012* xterm +sb¶