sowm

commit 7193af1ef4f4006c6d5954813349fe6bb50d55ce
parent f46c951ad25aeb94c92155001b15b94d85b78ed1
Author: Dylan Araps <dylan.araps@gmail.com>
Date:   Tue, 15 Oct 2019 13:40:54 +0300

docs: update

Diffstat:
M
sowm.c
 | 
13
+++++++++++++

1 file changed, 13 insertions(+), 0 deletions(-)
diff --git a/sowm.c b/sowm.c
@@ -207,6 +207,15 @@ void key_press(XEvent *e) {
             keys[i].function(keys[i].arg);
 }
 
+/*
+   On a mouse button press the window below the cursor's
+   attributes are stored, the window is raised and the 'mouse'
+   global is set.
+
+   Setting the 'mouse' global tells the motion handling function
+   that it should operate on the window as the user desires a move
+   or resize.
+*/
 void button_press(XEvent *e) {
     if (e->xbutton.subwindow == None) return;
 
@@ -215,6 +224,10 @@ void button_press(XEvent *e) {
     mouse = e->xbutton;
 }
 
+/*
+   On a mouse button release we simply unset the 'mouse' global
+   as all of this mouse pointer nonsense is done.
+*/
 void button_release() {
     mouse.subwindow = None;
 }