Merge branch 'master' into next

[i3/i3] / include / ewmh.h

diff --git a/include/ewmh.h b/include/ewmh.h
index c73c4a45cb36addaa7afeb8832b48e9ad5c03715..9cc589d124fbda58730f6b6dbb569e530da6c83c 100644 (file)
--- a/include/ewmh.h
+++ b/include/ewmh.h
@@ -1,15 +1,13 @@
 /*
- * vim:ts=8:expandtab
+ * vim:ts=4:sw=4:expandtab
  *
  * i3 - an improved dynamic tiling window manager
+ * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
  *
- * © 2009 Michael Stapelberg and contributors
- *
- * See file LICENSE for license information.
+ * ewmh.c: Get/set certain EWMH properties easily.
  *
  */
-#ifndef _EWMH_C
-#define _EWMH_C
+#pragma once
 
 /**
  * Updates _NET_CURRENT_DESKTOP with the current desktop number.
@@ -18,7 +16,7 @@
  * and _NET_NUMBER_OF_DESKTOPS - 1.
  *
  */
-void ewmh_update_current_desktop();
+void ewmh_update_current_desktop(void);
 
 /**
  * Updates _NET_ACTIVE_WINDOW with the currently focused window.
@@ -30,13 +28,36 @@ void ewmh_update_current_desktop();
 void ewmh_update_active_window(xcb_window_t window);
 
 /**
- * Updates the workarea for each desktop.
+ * Updates the _NET_CLIENT_LIST_STACKING hint. Necessary to move tabs in
+ * Chromium correctly.
+ *
+ * EWMH: These arrays contain all X Windows managed by the Window Manager.
+ * _NET_CLIENT_LIST has initial mapping order, starting with the oldest window.
+ * _NET_CLIENT_LIST_STACKING has bottom-to-top stacking order. These properties
+ * SHOULD be set and updated by the Window Manager.
+ *
+ */
+void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows);
+
+/**
+ * Set up the EWMH hints on the root window.
+ *
+ */
+void ewmh_setup_hints(void);
+
+/**
+ * i3 currently does not support _NET_WORKAREA, because it does not correspond
+ * to i3’s concept of workspaces. See also:
+ * http://bugs.i3wm.org/539
+ * http://bugs.i3wm.org/301
+ * http://bugs.i3wm.org/1038
+ *
+ * We need to actively delete this property because some display managers (e.g.
+ * LightDM) set it.
  *
  * EWMH: Contains a geometry for each desktop. These geometries specify an area
  * that is completely contained within the viewport. Work area SHOULD be used by
  * desktop applications to place desktop icons appropriately.
  *
  */
-void ewmh_update_workarea();
-
-#endif
+void ewmh_update_workarea(void);