X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=openbox%2Fstacking.h;h=edcedea24909235955b525c5bc73d7c97bceb126;hb=f189b02f857eb5cc80ca925ccb4b0e97c3614bcd;hp=083d20249f57559ea92f5df758797257139ccf6d;hpb=7120face258ee4bd71fb19ded271665acde6465c;p=chaz%2Fopenbox

diff --git a/openbox/stacking.h b/openbox/stacking.h
index 083d2024..edcedea2 100644
--- a/openbox/stacking.h
+++ b/openbox/stacking.h
@@ -1,3 +1,22 @@
+/* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
+
+   stacking.h for the Openbox window manager
+   Copyright (c) 2006        Mikael Magnusson
+   Copyright (c) 2003        Ben Jansens
+
+   This program is free software; you can redistribute it and/or modify
+   it under the terms of the GNU General Public License as published by
+   the Free Software Foundation; either version 2 of the License, or
+   (at your option) any later version.
+
+   This program is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU General Public License for more details.
+
+   See the COPYING file for a copy of the GNU General Public License.
+*/
+
 #ifndef __stacking_h
 #define __stacking_h
 
@@ -8,18 +27,17 @@
 
 /*! The possible stacking layers a client window can be a part of */
 typedef enum {
-    OB_STACKING_LAYER_DESKTOP,    /*!< 0 - desktop windows */
-    OB_STACKING_LAYER_BELOW,      /*!< 1 - normal windows w/ below */
-    OB_STACKING_LAYER_NORMAL,     /*!< 2 - normal windows */
-    OB_STACKING_LAYER_ABOVE,      /*!< 3 - normal windows w/ above */
-    OB_STACKING_LAYER_TOP,        /*!< 4 - always-on-top-windows (docks?) */
-    OB_STACKING_LAYER_FULLSCREEN, /*!< 5 - fullscreeen windows */
-    OB_STACKING_LAYER_INTERNAL,   /*!< 6 - openbox windows/menus */
+    OB_STACKING_LAYER_DESKTOP,     /*!< 0 - desktop windows */
+    OB_STACKING_LAYER_BELOW,       /*!< 1 - normal windows w/ below */
+    OB_STACKING_LAYER_NORMAL,      /*!< 2 - normal windows */
+    OB_STACKING_LAYER_ABOVE,       /*!< 3 - normal windows w/ above */
+    OB_STACKING_LAYER_FULLSCREEN,  /*!< 4 - fullscreeen windows */
+    OB_STACKING_LAYER_INTERNAL,    /*!< 5 - openbox windows/menus */
     OB_NUM_STACKING_LAYERS
 } ObStackingLayer;
 
 /* list of ObWindow*s in stacking order from highest to lowest */
-extern GList  *stacking_list;
+extern GList *stacking_list;
 
 /*! Sets the window stacking list on the root window from the
   stacking_list */
@@ -30,12 +48,15 @@ void stacking_add_nonintrusive(ObWindow *win);
 #define stacking_remove(win) stacking_list = g_list_remove(stacking_list, win);
 
 /*! Raises a window above all others in its stacking layer */
-void stacking_raise(ObWindow *window);
+void stacking_raise(ObWindow *window, gboolean group);
 
 /*! Lowers a window below all others in its stacking layer */
-void stacking_lower(ObWindow *window);
+void stacking_lower(ObWindow *window, gboolean group);
 
-/*! Moves a window below another if its in the same layer */
+/*! Moves a window below another if its in the same layer.
+  This function does not enforce stacking rules IRT transients n such, and so
+  it should really ONLY be used to restore stacking orders from saved sessions
+*/
 void stacking_below(ObWindow *window, ObWindow *below);
 
 #endif