X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=wm.h;h=57d79a37481ab31d243ee9d08d89bb321eb65342;hb=4d7f5ec4dcc436ba1b29a0db8fe4531fccc48af8;hp=024faa771f8bd17b5df0598fcd093c001db98a7d;hpb=ee556f1413d9da165fd6ea74f0bf4039ab28da0d;p=wmpus

diff --git a/wm.h b/wm.h
index 024faa7..57d79a3 100644
--- a/wm.h
+++ b/wm.h
@@ -1,9 +1,47 @@
-void wm_init(win_t *root);
+/*
+ * Copyright (c) 2011-2012, Andy Spencer <andy753421@gmail.com>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ */
+
+/* Window manager interface:
+ *
+ * The window manager receives input events from the system
+ * and responds by using the system to arrange the windows
+ * according to it's layout.
+ *
+ * The window provided to these function is generally the
+ * window with the keyboard or mouse focus. */
 
-int wm_handle_key(win_t *win, Key_t key, mod_t mod, ptr_t ptr);
+/* Refresh the window layout */
+void wm_update(void);
 
+/* Called for each watched event */
+int wm_handle_event(win_t *win, event_t ev, mod_t mod, ptr_t ptr);
+
+/* Called for each mouse movement */
 int wm_handle_ptr(win_t *win, ptr_t ptr);
 
+/* Called when a window changes states */
+int wm_handle_state(win_t *win, state_t prev, state_t next);
+
+/* Begin managing a window, called for each new window */
 void wm_insert(win_t *win);
 
+/* Stop managing a window and free data */
 void wm_remove(win_t *win);
+
+/* First call, sets up key bindings, etc */
+void wm_init(win_t *root);
+
+/* First call, sets up key bindings, etc */
+void wm_free(win_t *root);