From: Dana Jansens <danakj@orodu.net>
Date: Mon, 25 Aug 2003 07:44:33 +0000 (+0000)
Subject: clarify that stacking_below sucks
X-Git-Url: https://git.brokenzipper.com/gitweb?a=commitdiff_plain;h=4739cf190b7294ee8c71375698bec5d18d958859;p=chaz%2Fopenbox

clarify that stacking_below sucks
---

diff --git a/openbox/stacking.h b/openbox/stacking.h
index 083d2024..8a8ca099 100644
--- a/openbox/stacking.h
+++ b/openbox/stacking.h
@@ -35,7 +35,10 @@ void stacking_raise(ObWindow *window);
 /*! Lowers a window below all others in its stacking layer */
 void stacking_lower(ObWindow *window);
 
-/*! 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