From d11291df3e9ef0173139a97bf6c77471ab3a4119 Mon Sep 17 00:00:00 2001 From: Dana Jansens Date: Fri, 31 Jan 2003 23:54:05 +0000 Subject: [PATCH] doc the state functions better --- scripts/callbacks.py | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/scripts/callbacks.py b/scripts/callbacks.py index 0478e079..91f005a1 100644 --- a/scripts/callbacks.py +++ b/scripts/callbacks.py @@ -11,35 +11,45 @@ import ob import otk def state_above(data, add=2): - """Toggles, adds or removes the 'above' state on a window.""" + """Toggles, adds or removes the 'above' state on a window. + The second paramater should one of: 0 - removes the state, 1 - adds the + state, 2 - toggles the state.""" if not data.client: return ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(), otk.Property_atoms().net_wm_state, data.client.window(), add, otk.Property_atoms().net_wm_state_above) def state_below(data, add=2): - """Toggles, adds or removes the 'below' state on a window.""" + """Toggles, adds or removes the 'below' state on a window. + The second paramater should one of: 0 - removes the state, 1 - adds the + state, 2 - toggles the state.""" if not data.client: return ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(), otk.Property_atoms().net_wm_state, data.client.window(), add, otk.Property_atoms().net_wm_state_below) def state_shaded(data, add=2): - """Toggles, adds or removes the 'shaded' state on a window.""" + """Toggles, adds or removes the 'shaded' state on a window. + The second paramater should one of: 0 - removes the state, 1 - adds the + state, 2 - toggles the state.""" if not data.client: return ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(), otk.Property_atoms().net_wm_state, data.client.window(), add, otk.Property_atoms().net_wm_state_shaded) def state_skip_taskbar(data, add=2): - """Toggles, adds or removes the 'skip_taskbar' state on a window.""" + """Toggles, adds or removes the 'skip_taskbar' state on a window. + The second paramater should one of: 0 - removes the state, 1 - adds the + state, 2 - toggles the state.""" if not data.client: return ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(), otk.Property_atoms().net_wm_state, data.client.window(), add, otk.Property_atoms().net_wm_state_skip_taskbar) def state_skip_pager(data, add=2): - """Toggles, adds or removes the 'skip_pager' state on a window.""" + """Toggles, adds or removes the 'skip_pager' state on a window. + The second paramater should one of: 0 - removes the state, 1 - adds the + state, 2 - toggles the state.""" if not data.client: return ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(), otk.Property_atoms().net_wm_state, data.client.window(), -- 2.39.2