From: Michael Stapelberg <michael@stapelberg.de>
Date: Sat, 5 Mar 2011 19:35:16 +0000 (+0100)
Subject: document the different cases for click handling
X-Git-Tag: tree-pr2~14
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=5024c0da95838ad67b076a00e9b8f89d37577d24;p=i3%2Fi3

document the different cases for click handling
---

diff --git a/docs/hacking-howto b/docs/hacking-howto
index 48d717f1..03da8ef1 100644
--- a/docs/hacking-howto
+++ b/docs/hacking-howto
@@ -612,6 +612,21 @@ When moving up/down, the container needs to leave the floating container and it
 needs to be placed on the workspace (at workspace level). This is accomplished
 by calling the function +attach_to_workspace+.
 
+== Click handling
+
+Without much ado, here is the list of cases which need to be considered:
+
+* click to focus (tiling + floating) and raise (floating)
+* click to focus/raise when in stacked/tabbed mode
+* floating_modifier + left mouse button to drag a floating con
+* floating_modifier + right mouse button to resize a floating con
+* click on decoration in a floating con to either initiate a resize (if there
+  is more than one child in the floating con) or to drag the
+  floating con (if it’s the one at the top).
+* click on border in a floating con to resize the floating con
+* floating_modifier + right mouse button to resize a tiling con
+* click on border/decoration to resize a tiling con
+
 == Gotchas
 
 * Forgetting to call `xcb_flush(conn);` after sending a request. This usually