From: Dana Jansens <danakj@orodu.net>
Date: Sat, 4 Jan 2003 18:48:09 +0000 (+0000)
Subject: add focusraise.
X-Git-Url: https://git.brokenzipper.com/gitweb?a=commitdiff_plain;h=69c257faa94334b8d19fc97292622499c43929db;p=chaz%2Fopenbox

add focusraise.
comment functions.
---

diff --git a/scripts/builtins.py b/scripts/builtins.py
index 45f73d56..3571e017 100644
--- a/scripts/builtins.py
+++ b/scripts/builtins.py
@@ -69,35 +69,43 @@ def resize(data):
                     data.press_clientheight() + dy);
 
 def restart(data):
+    """Restarts openbox"""
     Openbox_restart(openbox, "")
 
-def toggle_shade(data):
-    print "toggle_shade"
-
 def raise_win(data):
+    """Raises the window on which the event occured"""
     client = Openbox_findClient(openbox, data.window())
     if not client: return
     screen = Openbox_screen(openbox, OBClient_screen(client))
     OBScreen_restack(screen, 1, client)
 
 def lower_win(data):
+    """Lowers the window on which the event occured"""
     client = Openbox_findClient(openbox, data.window())
     if not client: return
     screen = Openbox_screen(openbox, OBClient_screen(client))
     OBScreen_restack(screen, 0, client)
 
+def focusraise(data):
+    """Focuses and raises the window on which the event occured"""
+    focus(data)
+    raise_win(data)
+
 def toggle_shade(data):
+    """Toggles the shade status of the window on which the event occured"""
     client = Openbox_findClient(openbox, data.window())
     if not client: return
     print "toggle_shade"
     OBClient_shade(client, not OBClient_shaded(client))
 
 def shade(data):
+    """Shades the window on which the event occured"""
     client = Openbox_findClient(openbox, data.window())
     if not client: return
     OBClient_shade(client, 1)
 
 def unshade(data):
+    """Unshades the window on which the event occured"""
     client = Openbox_findClient(openbox, data.window())
     if not client: return
     OBClient_shade(client, 0)
@@ -107,6 +115,9 @@ def unshade(data):
 #########################################
 
 def execute(bin, screen = 0):
+    """Executes a command on the specified screen. It is recommended that you
+       use this call instead of a python system call. If the specified screen
+       is beyond your range of screens, the default is used instead."""
     Openbox_execute(openbox, screen, bin)
 
 print "Loaded builtins.py"