From 8d8d325b929252e9d8d4a22b1314b241b06abc8a Mon Sep 17 00:00:00 2001 From: Jeff Abrahamson Date: Tue, 30 Sep 2014 15:44:45 +0200 Subject: [PATCH 2/2] Document focus_policy. --- doc/ratpoison.mdoc.1 | 3 +++ doc/ratpoison.texi | 18 ++++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/doc/ratpoison.mdoc.1 b/doc/ratpoison.mdoc.1 index 2e3c356..863228b 100644 --- a/doc/ratpoison.mdoc.1 +++ b/doc/ratpoison.mdoc.1 @@ -371,6 +371,9 @@ Switch to the frame to the right of the current one. Focus the previous frame. .It Ic focusup Pq Ic C\-t Up Switch to the frame above the current one. +.It Ic focus_policy +Tell ratpoison whether and how to interpret rodent movements for focusing frames. +Possible values are manual (the default), sloppy, and ffm (focus follows mouse). .It Ic frestore Ar frames Replace the current frames with the ones specified in .Ar frames diff --git a/doc/ratpoison.texi b/doc/ratpoison.texi index d12501f..01ca15b 100644 --- a/doc/ratpoison.texi +++ b/doc/ratpoison.texi @@ -807,6 +807,24 @@ Move to the frame right of the current frame. Move to the frame above the current frame. @end deffn address@hidden Command focus_policy +Tell ratpoison whether and how to interpret mouse movement for focusing frames. +The default behavior, ``manual'', is to ignore the rodent. This is, of course, +the default. +The other two possibilities are ``sloppy'' and ``ffm'' (focus follows mouse). + +In sloppy mode, the mouse focuses a frame when it enters, but leaving a +frame (for example, because the next frame has no window mapped in it) +does not change focus. This is useful when you like to push the mouse +over a nearby empty frame without changing focus. On the other hand, the +empty frame must be focused by keyboard actions in sloppy mode. + +In ffm mode, the focus really does follow the mouse: mousing over an empty frame +focuses that empty frame. This can be useful for creating new windows in empty frames. + +Of course, regardless of focus policy, the keyboard focus commands are available and work correctly. address@hidden deffn + @node Saving and Restoring Frame Sets @section Saving and Restoring Frame Sets ratpoison provides two commands, @command{fdump} and -- 1.9.1