Sawfish recognizes keyboard actions and mouse actions.
Keys pressed on the keyboard generate one or more key press events, followed by a key release event. Bindings normally recognize key press events only. To recognize key releases, add a Release modifier to the bound event.
Generally keys have the same names as their X keysyms. The following unusual names are worth listing: ‘SPC’, ‘TAB’, ‘RET’, ‘ESC’, ‘BS’, ‘DEL’, ‘Up’, ‘Down’, ‘Left’, ‘Right’.
For example, pressing the Delete key while Control is held down generates a Control-DEL event, while releasing the a key while Hyper is held down generates a H-Release-a event.
Button presses generate Click actions. If Sawfish receives
several clicks in close succession (less than
milliseconds between clicks), the second and third events are
Click2 and Click3, respectively. Any further clicks are
simple Click events. For consistency, Click1 is a synonym
Once the button has been released from a ClickN action, Sawfish receives a corresponding OffN action. The actions Off and Off1 are synonyms.
Pointer motion generates Move actions. The action does not
indicate anything about the pointer position; use e.g.,
query-last-pointer to find that information.
For example, a single click of the left mouse button with the Meta key held would be described as M-Button1-Click1. After triple-clicking with the Alt key held down, Sawfish will receive a Alt-Off3 event.
An integer indicating the maximum number of milliseconds between
successive clicks. Defaults to 250 milliseconds at startup; if
nil, Sawfish uses 250 milliseconds.