X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=ionconf%2Fnode7.html;h=f4a93eec1e36ae429f5f212070609b98eda73969;hb=428266c577f55bd77cf036ed0d2af379613471e4;hp=628a67028af7057943ef75d7a974892bc334e55d;hpb=16a5f824c31d29598763c5f49918ef67a47ad7e0;p=ion3-doc.git diff --git a/ionconf/node7.html b/ionconf/node7.html index 628a670..f4a93ee 100644 --- a/ionconf/node7.html +++ b/ionconf/node7.html @@ -28,31 +28,31 @@ original version by: Nikos Drakos, CBLU, University of Leeds
- next - up - previous - contents - index
- Next: A. The GNU General - Up: Next: A. GNU Free Documentation + Up: Configuring and extending Ion3 - Previous: Previous: 5. Scripting -   Contents -   Index

@@ -61,90 +61,106 @@ original version by: Nikos Drakos, CBLU, University of Leeds Subsections
@@ -163,9 +179,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds
-
- - +
Synopsis:
ioncore.TR(s, ...) @@ -180,9 +194,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

-
- - +
Synopsis:
ioncore.bdoc(text) @@ -198,9 +210,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

-
- - +
Synopsis:
ioncore.chdir_for(reg, dir) @@ -215,9 +225,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

-
- - +
Synopsis:
ioncore.compile_cmd(cmd, guard) @@ -242,9 +250,22 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
+
+
Synopsis:
+
WTimer ioncore.create_timer() + +
+
Description:
+
Create a new timer. + +
+
+ +

+ +

+
Synopsis:
ioncore.create_ws(scr, tmpl, layout) @@ -261,9 +282,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.defbindings(context, bindings) @@ -272,7 +291,7 @@ The string guard maybe set to pose limits on _sub. Currently
Description:
Define bindings for context context. Here binding is a table composed of entries created with ioncore.kpress, - etc.; see section 3.3 for details. + etc.; see Section 3.3 for details.
@@ -280,9 +299,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.defctxmenu(ctx, ...) @@ -298,9 +315,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.deflayout(name, tab) @@ -317,9 +332,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.defmenu(name, tab) @@ -336,9 +349,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.defwinprop(list) @@ -353,9 +364,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.exec_on(reg, cmd, merr_internal) @@ -376,9 +385,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
table ioncore.read_savefile(string basename) @@ -393,9 +400,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
string ioncore.get_savefile(string basename) @@ -411,9 +416,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
string ioncore.lookup_script(string file, string sp) @@ -429,9 +432,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
bool ioncore.write_savefile(string basename, table tab) @@ -447,9 +448,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.find_manager(obj, t) @@ -465,9 +464,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.get_dir_for(reg) @@ -482,9 +479,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.getbindings(maybe_context) @@ -499,9 +494,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.getctxmenu(name) @@ -516,9 +509,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.getlayout(name, all) @@ -534,9 +525,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.getmenu(name) @@ -551,9 +540,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
ioncore.getwinprop(cwin) @@ -568,9 +555,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
string ioncore.aboutmsg() @@ -585,16 +570,14 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
WRegion ioncore.activity_first()
Description:
-
Return first regio non activity list. +
Returns first region on activity list.
@@ -602,9 +585,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
bool ioncore.activity_i(function iterfn) @@ -612,7 +593,8 @@ The string guard maybe set to pose limits on _sub. Currently
Description:
Iterate over activity list until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -621,26 +603,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - -
-
Synopsis:
-
void ioncore.clear_tags() - -
-
Description:
-
Untag all regions. - -
-
- -

- -

-
- - +
Synopsis:
bool ioncore.clientwin_i(function fn) @@ -648,7 +611,8 @@ The string guard maybe set to pose limits on _sub. Currently
Description:
Iterate over client windows until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -657,9 +621,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
WRegion ioncore.current() @@ -674,9 +636,7 @@ The string guard maybe set to pose limits on _sub. Currently

-
- - +
Synopsis:
bool ioncore.defshortening(string rx, string rule, bool always) @@ -728,23 +688,26 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
bool ioncore.detach(WRegion reg, string how)
Description:
-
Detach or reattach reg, depending on whether how - is 'set'/'unset'/'toggle'. (Detaching means making reg - managed by its nearest ancestor WGroup, framed if reg is - not itself WFrame. Reattaching means making it managed where - it used to be managed, if a return-placeholder exists.) - If reg is the 'bottom' of some group, the whole group is - detached. If reg is a WWindow, it is put into a - frame. +
Detach or reattach reg or any group it is the leader of + (see WRegion.groupleader_of), depending on whether how + is `set', `unset' or `toggle'. If this + region is not a window, it is put into a frame. + +

+Detaching a region means having it managed by its nearest ancestor + WGroup. Reattaching means having it managed where it used + to be managed, if a ``return placeholder'' exists. + +

+Additionally, setting how to `forget', can be used to + clear this return placeholder of the group leader of reg.

@@ -752,9 +715,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
integer ioncore.exec(string cmd) @@ -772,9 +733,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
WScreen ioncore.find_screen_id(integer id) @@ -789,9 +748,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
bool ioncore.focushistory_i(function iterfn) @@ -799,7 +756,8 @@ Similarly to sed's 's' command, rule may contain characters that are
Description:
Iterate over focus history until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -808,9 +766,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
table ioncore.get() @@ -825,16 +781,15 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
table ioncore.get_paths(table tab)
Description:
-
Get important directories (userdir, sessiondir, searchpath). +
Get important directories (the fields userdir, + sessiondir, searchpath in the returned table).
@@ -842,9 +797,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
bool ioncore.goto_activity() @@ -859,20 +812,17 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
WRegion ioncore.goto_first(WRegion reg, string dirstr, table param)
Description:
-
Go to first region within reg in direction dirstr - (up/down/left/right/beg/end/any). For information on param, - see ioncore.navi_next. Additionally this function supports - the boolean nofront field, for not bringing the object to - front. +
Go to first region within reg in direction dirstr. + For information on param, see ioncore.navi_next. + Additionally this function supports the boolean nofront field, + for not bringing the object to front.
@@ -880,20 +830,17 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
WRegion ioncore.goto_next(WRegion reg, string dirstr, table param)
Description:
-
Go to region next from reg in direction dirstr - (up/down/left/right/next/prev/any). For information on param, - see ioncore.navi_next. Additionally this function supports - the boolean nofront field, for not bringing the object to - front. +
Go to region next from reg in direction dirstr. + For information on param, see ioncore.navi_next. + Additionally this function supports the boolean nofront + field, for not bringing the object to front.
@@ -901,9 +848,7 @@ Similarly to sed's 's' command, rule may contain characters that are

-
- - +
Synopsis:
WScreen ioncore.goto_next_screen() @@ -922,9 +867,7 @@ Note that this function is asynchronous; the screen will not

-
- - +
Synopsis:
WScreen ioncore.goto_nth_screen(integer id) @@ -943,9 +886,7 @@ Note that this function is asynchronous; the screen will not

-
- - +
Synopsis:
WScreen ioncore.goto_prev_screen() @@ -964,9 +905,7 @@ Note that this function is asynchronous; the screen will not

-
- - +
Synopsis:
WRegion ioncore.goto_previous() @@ -985,9 +924,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool ioncore.is_i18n() @@ -1002,9 +939,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool ioncore.load_module(string modname) @@ -1019,9 +954,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WClientWin ioncore.lookup_clientwin(string name) @@ -1036,9 +969,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion ioncore.lookup_region(string name, string typenam) @@ -1054,18 +985,15 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion ioncore.navi_first(WRegion reg, string dirstr, table param)
Description:
-
Find first region within reg in direction dirstr - (up/down/left/right/beg/end/any). For information on param, - see ioncore.navi_next. +
Find first region within reg in direction dirstr. + For information on param, see ioncore.navi_next.
@@ -1073,9 +1001,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion ioncore.navi_next(WRegion reg, string dirstr, table param) @@ -1083,12 +1009,13 @@ Note that this function is asynchronous; the region will not
Description:
Find region next from reg in direction dirstr - (up/down/left/right/next/prev/any). The table param may - contain the boolean field nowrap, instructing not to wrap + (`up', `down', `left', `right', + `next', `prev', or `any'). The table param + may contain the boolean field nowrap, instructing not to wrap around, and the WRegions no_ascend and no_descend, - and functions ascend_filter and descend_filter from - WRegions (to, from), used to decide when to descend - or ascend into another region. (TODO: more detailed explanation.) + and boolean functions ascend_filter and descend_filter + on WRegion pairs (to, from), are used to decide when + to descend or ascend into another region.
@@ -1096,18 +1023,19 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
integer ioncore.popen_bgread(string cmd, function h, function errh) +
integer ioncore.popen_bgread(string cmd, function h, function errh, string wd)
Description:
-
Run cmd with a read pipe connected to its stdout. - When data is received through the pipe, handler is called - with that data. +
Run cmd in directory wd with a read pipe connected to its + stdout and stderr. + When data is received through one of these pipes, h or errh + is called with that data. When the pipe is closed, the handler is called + with nil argument. The PID of the new process is returned, or + -1 on error.
@@ -1115,9 +1043,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string ioncore.progname() @@ -1132,9 +1058,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool ioncore.region_i(function fn, string typenam) @@ -1143,7 +1067,8 @@ Note that this function is asynchronous; the region will not
Description:
Iterate over all non-client window regions with (inherited) class typenam until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -1152,9 +1077,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void ioncore.request_selection(function fn) @@ -1170,9 +1093,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void ioncore.resign() @@ -1188,9 +1109,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void ioncore.restart() @@ -1205,9 +1124,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void ioncore.restart_other(string cmd) @@ -1222,9 +1139,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void ioncore.set(table tab) @@ -1260,7 +1175,8 @@ Note that this function is asynchronous; the region will not frame_default_index (string) Specifies where to add new regions on the mutually exclusive list of a frame. One of - ''last'', ''next'' (for after current), ''next-act'' + `last', `next', (for after current), + or `next-act' (for after current and anything with activity right after it). @@ -1284,13 +1200,27 @@ Note that this function is asynchronous; the region will not kbresize_maxacc (floating point) See below. +edge_resistance +(integer) Resize edge resistance in pixels. + framed_transients (boolean) Put transients in nested frames. float_placement_method (string) How to place floating frames. - One of ''udlr'' (up-down, then left-right), - ''lrud'' (left-right, then up-down) or ''random''. + One of `udlr' (up-down, then left-right), + `lrud' (left-right, then up-down), or + `random'. + +mousefocus +(string) Mouse focus mode: + `disable' or `sloppy'. + +unsqueeze +(boolean) Auto-unsqueeze transients/menus/queries/etc. + +autoraise +(boolean) Autoraise regions in groups on goto. @@ -1309,16 +1239,15 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
bool ioncore.set_paths(table tab)
Description:
-
Set important directories (sessiondir, searchpath). +
Set important directories (the fields sessiondir, searchpath + of tab).
@@ -1326,9 +1255,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.set_selection(string p) @@ -1343,9 +1270,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.shutdown() @@ -1360,9 +1285,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.snapshot() @@ -1377,16 +1300,29 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
+
+
Synopsis:
+
void ioncore.tagged_clear() + +
+
Description:
+
Untag all regions. + +
+
+ +

+ +

+
Synopsis:
-
WRegion ioncore.tagged_first() +
WRegion ioncore.tagged_first(bool untag)
Description:
-
Returns first tagged object. +
Returns first tagged object, untagging it as well if untag is set.
@@ -1394,9 +1330,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
bool ioncore.tagged_i(function iterfn) @@ -1404,7 +1338,8 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Iterate over tagged regions until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -1413,9 +1348,25 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
+
+
Synopsis:
+
void ioncore.unsqueeze(WRegion reg, bool override) + +
+
Description:
+
Try to detach reg if it fits poorly in its + current location. This function does not do anything, + unless override is set or the unsqueeze option + of ioncore.set is set. + +
+
+ +

+ +

+
Synopsis:
string ioncore.version() @@ -1430,9 +1381,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.warn(string str) @@ -1448,9 +1397,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.warn_traced(string str) @@ -1465,9 +1412,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.x_change_property(integer win, integer atom, integer atom_type, integer format, string mode, table tab) @@ -1475,7 +1420,7 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Modify a window property. The mode is one of - "replace", "prepend" or "append", and format + `replace', `prepend' or `append', and format is either 8, 16 or 32. Also see ioncore.x_get_window_property and the XChangeProperty(3) manual page. @@ -1485,9 +1430,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.x_delete_property(integer win, integer atom) @@ -1502,9 +1445,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
string ioncore.x_get_atom_name(integer atom) @@ -1520,17 +1461,14 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
table ioncore.x_get_text_property(integer win, integer atom)
Description:
-
Get a text property for a window (STRING, COMPOUND_TEXT, - or UTF8_STRING property converted). The fields in the returned +
Get a text property for a window. The fields in the returned table (starting from 1) are the null-separated parts of the property. See the XGetTextProperty(3) manual page for more information. @@ -1540,9 +1478,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
table ioncore.x_get_window_property(integer win, integer atom, integer atom_type, integer n32expected, bool more) @@ -1562,9 +1498,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
integer ioncore.x_intern_atom(string name, bool only_if_exists) @@ -1579,9 +1513,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void ioncore.x_set_text_property(integer win, integer atom, table tab) @@ -1598,9 +1530,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.kpress(keyspec, cmd, guard) @@ -1608,8 +1538,9 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Creates a binding description table for the action of pressing a key given - by keyspec (with possible modifiers) to the function func. - For more information on bindings, see section 3.3. + by keyspec (with possible modifiers) to the function cmd. + The guard controls when the binding can be called. + For more informationp see Section 3.3.
@@ -1617,19 +1548,47 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.kpress_wait(keyspec, cmd, guard)
Description:
-
This is similar to kpress but after calling cmd, +
This is similar to ioncore.kpress but after calling cmd, Ioncore waits for all modifiers to be released before processing any further actions. - For more information on bindings, see section 3.3. + For more information on bindings, see Section 3.3. + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool ioncore.defer(function fn) + +
+
Description:
+
Defer execution of fn until the main loop. + +
+
+ +

+ +

+
+
+
Synopsis:
+
WHook ioncore.get_hook(string name) + +
+
Description:
+
Find named hook name.
@@ -1637,12 +1596,10 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
-
ioncore.match_winprop_name(prop, cwin) +
ioncore.match_winprop_dflt(prop, cwin, id)
Description:
@@ -1654,9 +1611,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.mclick(buttonspec, cmd, guard) @@ -1665,8 +1620,8 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Creates a binding description table for the action of clicking a mouse button while possible modifier keys are pressed, - both given by buttonspec, to the function func. - For more information, see section 3.3. + both given by buttonspec, to the function cmd. + For more information, see Section 3.3.
@@ -1674,17 +1629,15 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.mdblclick(buttonspec, cmd, guard)
Description:
-
Similar to mclick but for double-click. - Also see section 3.3. +
Similar to ioncore.mclick but for double-click. + Also see Section 3.3.
@@ -1692,9 +1645,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.mdrag(buttonspec, cmd, guard) @@ -1713,19 +1664,21 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
-
ioncore.menuentry(name, cmd, guard) +
ioncore.menuentry(name, cmd, guard_or_opts)
Description:
Use this function to define normal menu entries. The string name - is the string shown in the visual representation of menu, and the - parameter cmd and guard are similar to those of - ioncore.defbindings. + is the string shown in the visual representation of menu. The + parameter cmd and guard_or_opts (when string) are similar + to those of ioncore.defbindings. If guard_or_opts is + a table, it may contains the guard field, and the priority + field, for controlling positioning of entries in context menus. + (The default priority is 1 for most entries, and -1 for auto-generated + submenus.)
@@ -1733,17 +1686,15 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.mpress(buttonspec, cmd, guard)
Description:
-
Similar to mclick but for just pressing the mouse button. - Also see section 3.3. +
Similar to ioncore.mclick but for just pressing the mouse button. + Also see Section 3.3.
@@ -1751,9 +1702,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.refresh_stylelist() @@ -1768,19 +1717,47 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
-
ioncore.submap(kcb_, list) +
ioncore.submap(keyspec, list)
Description:
Returns a function that creates a submap binding description table. When the key press action keyspec occurs, Ioncore will wait for a further key presse and act according to the submap. - For details, see section 3.3. + For details, see Section 3.3. + +
+
+ +

+ +

+
+
+
Synopsis:
+
ioncore.submap_enter(cmd, guard) + +
+
Description:
+
Submap enter event for bindings. + +
+
+ +

+ +

+
+
+
Synopsis:
+
ioncore.submap_wait(cmd, guard) + +
+
Description:
+
Submap modifier release event for bindings.
@@ -1788,9 +1765,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
ioncore.submenu(name, sub_or_name, options) @@ -1808,6 +1783,59 @@ When a keyboard resize function is called, and at most kbresize_t_max
+

+ +

+
+
+
Synopsis:
+
ioncore.tabnum.clear() + +
+
Description:
+
Clear all tab numbers set by ioncore.tabnum.show. + +
+
+ +

+ +

+
+
+
Synopsis:
+
ioncore.tabnum.show(frame, delay) + +
+
Description:
+
Show tab numbers on frame, clearing them when submap + grab is released the next time. If delay is given, in + milliseconds, the numbers are not actually displayed until this + time has passed. + +
+
+ +

+ +

+
+
+
Synopsis:
+
ioncore.tagged_attach(reg, param) + +
+
Description:
+
Attach tagged regions to reg. The method of attach + depends on the types of attached regions and whether reg + implements attach_framed and attach. If param + is not set, the default of {switchto=true} is used. + The function returns true if all tagged regions were + succesfully attached, and false otherwisse. + +
+
+

@@ -1817,9 +1845,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
table WClientWin.get_ident(WClientWin cwin) @@ -1837,17 +1863,15 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WClientWin.kill(WClientWin cwin)
Description:
-
Attempt to kill (with XKillWindow) the client that owns the X - window correspoding to cwin. +
Attempt to kill (with XKillWindow) the client that owns + the X window correspoding to cwin.
@@ -1855,9 +1879,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WClientWin.nudge(WClientWin cwin) @@ -1873,9 +1895,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WClientWin.quote_next(WClientWin cwin) @@ -1890,9 +1910,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
double WClientWin.xid(WClientWin cwin) @@ -1913,9 +1931,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
bool WFrame.is_shaded(WFrame frame) @@ -1930,9 +1946,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WFrame.maximize_horiz(WFrame frame) @@ -1947,9 +1961,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WFrame.maximize_vert(WFrame frame) @@ -1964,9 +1976,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
string WFrame.mode(WFrame frame) @@ -1981,9 +1991,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WFrame.p_switch_tab(WFrame frame) @@ -1999,9 +2007,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
void WFrame.p_tabdrag(WFrame frame) @@ -2010,7 +2016,7 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Start dragging the tab that the user pressed on with the pointing device. This function should only be used by binding it to mpress or - mdrag action with area ''tab''. + mdrag action with area `tab'.
@@ -2018,16 +2024,16 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
-
bool WFrame.set_mode(WFrame frame, string modestr) +
bool WFrame.set_grattr(WFrame frame, string attr, string how)
Description:
-
Set frame mode. +
Set extra drawing engine attributes for the frame. + The parameter attr is the attribute, and how is + one of `set', `unset', or `toggle'.
@@ -2035,18 +2041,16 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
-
bool WFrame.set_numbers(WFrame frame, string how) +
bool WFrame.set_mode(WFrame frame, string modestr)
Description:
-
Control whether tabs show numbers (set/unset/toggle). - Resulting state is returned, which may not be what was - requested. +
Set frame mode (one of + `unknown', `tiled', `floating', `transient', + or any of these suffixed with `-alt').
@@ -2054,9 +2058,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
bool WFrame.set_shaded(WFrame frame, string how) @@ -2064,7 +2066,8 @@ When a keyboard resize function is called, and at most kbresize_t_max
Description:
Set shading state according to the parameter how - (set/unset/toggle). Resulting state is returned, which may not be + (`set', `unset', or `toggle'). + Resulting state is returned, which may not be what was requested.
@@ -2079,9 +2082,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
WRegion WGroup.attach(WGroup ws, WRegion reg, table param) @@ -2098,9 +2099,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

-
- - +
Synopsis:
WRegion WGroup.attach_new(WGroup ws, table param) @@ -2116,22 +2115,26 @@ When a keyboard resize function is called, and at most kbresize_t_max Description type -Class name (a string) of the object to be created. Mandatory. +(string) Class of the object to be created. Mandatory. name -Name of the object to be created (a string). Optional. +(string) Name of the object to be created. switchto -Should the region be switched to (boolean)? Optional. +(boolean) Should the region be switched to? level -Stacking level; default is 1. +(integer) Stacking level; default is 1. modal -Make object modal; ignored if level is set. +(boolean) Make object modal; ignored if level is set. sizepolicy -Size policy. +(string) Size policy; see Section 6.10.1. + +bottom +(boolean) Mark the attached region as the + ``bottom'' of ws. @@ -2145,16 +2148,14 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WGroup.bottom(WGroup ws)
Description:
-
Returns the 'bottom' of ws. +
Returns the `bottom' of ws.
@@ -2162,16 +2163,18 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
-
bool WGroup.is_fullscreen(WGroup grp) +
bool WGroup.managed_i(WGroup ws, function iterfn)
Description:
-
Is reg in full screen mode? +
Iterate over managed regions of ws until iterfn returns + false. + The function is called in protected mode. + This routine returns true if it reaches the end of list + without this happening.
@@ -2179,19 +2182,15 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
-
bool WGroup.managed_i(WGroup ws, function iterfn) +
bool WGroup.set_bottom(WGroup ws, WRegion reg)
Description:
-
Iterate over managed regions of ws until iterfn returns - false. - The function itself returns true if it reaches the end of list - without this happening. +
Sets the `bottom' of ws. The region reg must already + be managed by ws, unless nil.
@@ -2199,9 +2198,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WGroup.set_fullscreen(WGroup grp, string how) @@ -2209,8 +2206,9 @@ In addition parameters to the region to be created are passed in this
Description:
Set client window reg full screen state according to the - parameter how (set/unset/toggle). Resulting state is returned, - which may not be what was requested. + parameter how (one of `set', `unset', or + `toggle'). Resulting state is returned, which may not be + what was requested.
@@ -2230,9 +2228,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WGroupWS.attach_framed(WGroupWS ws, WRegion reg, table t) @@ -2263,22 +2259,52 @@ In addition parameters to the region to be created are passed in this

-6.1.6 WInfoWin functions +6.1.6 WHook functions

-
- - +
Synopsis:
-
void WInfoWin.set_text(WInfoWin p, string str) +
bool WHook.add(WHook hk, function efn)
Description:
-
Set contents of the info window. +
Add efn to the list of functions to be called when the + hook hk is triggered. + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool WHook.listed(WHook hk, function efn) + +
+
Description:
+
Is fn hooked to hook hk? + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool WHook.remove(WHook hk, function efn) + +
+
Description:
+
Remove efn from the list of functions to be called when the + hook hk is triggered.
@@ -2286,15 +2312,34 @@ In addition parameters to the region to be created are passed in this

-6.1.7 WMPlex functions +6.1.7 WInfoWin functions +

+ +

+ +

+
+
+
Synopsis:
+
void WInfoWin.set_text(WInfoWin p, string str, integer maxw) + +
+
Description:
+
Set contents of the info window. + +
+
+ +

+ +

+6.1.8 WMPlex functions

-
- - +
Synopsis:
WRegion WMPlex.attach(WMPlex mplex, WRegion reg, table param) @@ -2311,9 +2356,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WMPlex.attach_new(WMPlex mplex, table param) @@ -2356,9 +2399,17 @@ In addition parameters to the region to be created are passed in this by e.g. the mutually exclusive list being empty. This option overrides switchto. +passive +(boolean) Skip in certain focusing operations. + +pseudomodal +(boolean) The attached region is ``pseudomodal'' + if the stacking level dictates it to be modal. + This means that the region may be hidden to display + regions with lesser stacking levels. + sizepolicy -(integer) Size policy. - (TODO: document them somewhere.) +(string) Size policy; see Section 6.10.1. geom (table) Geometry specification. @@ -2375,33 +2426,14 @@ In addition parameters to the region to be created are passed in this

-
- - -
-
Synopsis:
-
void WMPlex.attach_tagged(WMPlex mplex) - -
-
Description:
-
Attach all tagged regions to mplex. - -
-
- -

- -

-
- - +
Synopsis:
void WMPlex.dec_index(WMPlex mplex, WRegion r)
Description:
-
Move r ''right'' within objects managed by mplex on list 1. +
Move r ``left'' within objects managed by mplex on list 1.
@@ -2409,18 +2441,16 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
integer WMPlex.get_index(WMPlex mplex, WRegion reg)
Description:
-
Get index of reg within the multiplexer on list 1. The first region - managed by mplex has index zero. If reg is not managed by - mplex, -1 is returned. +
Get index of reg on the mutually exclusive list of mplex. + The indices begin from zero.. If reg is not on the list, + -1 is returned.
@@ -2428,9 +2458,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
table WMPlex.get_stdisp(WMPlex mplex) @@ -2446,16 +2474,14 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMPlex.inc_index(WMPlex mplex, WRegion r)
Description:
-
Move r ''right'' within objects managed by mplex on list 1. +
Move r ``right'' within objects managed by mplex on list 1.
@@ -2463,9 +2489,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WMPlex.is_hidden(WMPlex mplex, WRegion reg) @@ -2480,9 +2504,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WMPlex.managed_i(WMPlex mplex, function iterfn) @@ -2491,7 +2513,8 @@ In addition parameters to the region to be created are passed in this
Description:
Iterate over managed regions of mplex until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -2500,9 +2523,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
integer WMPlex.mx_count(WMPlex mplex) @@ -2517,9 +2538,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WMPlex.mx_current(WMPlex mplex) @@ -2535,9 +2554,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WMPlex.mx_i(WMPlex mplex, function iterfn) @@ -2546,7 +2563,8 @@ In addition parameters to the region to be created are passed in this
Description:
Iterate over numbered/mutually exclusive region list of mplex until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -2555,17 +2573,15 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WMPlex.mx_nth(WMPlex mplex, integer n)
Description:
-
Returns the n:th object managed by mplex on the - l:th layer. +
Returns the n:th object on the mutually exclusive + list of mplex.
@@ -2573,9 +2589,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
bool WMPlex.set_hidden(WMPlex mplex, WRegion reg, string how) @@ -2583,7 +2597,8 @@ In addition parameters to the region to be created are passed in this
Description:
Set the visibility of the region reg on mplex - as specified with the parameter how (set/unset/toggle). + as specified with the parameter how + (one of `set', `unset', or `toggle'). The resulting state is returned.
@@ -2592,22 +2607,26 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMPlex.set_index(WMPlex mplex, WRegion reg, integer index)
Description:
-
Set index of reg within the multiplexer to index within - the mutually exclusive list. Special values for index are: +
Set index of reg to index within the mutually exclusive + list of mplex. Special values for index are: - + - +
$-1$ Last.
$-2$ After WMPlex.mx_current.
@@ -2618,9 +2637,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WMPlex.set_stdisp(WMPlex mplex, table t) @@ -2638,15 +2655,19 @@ In addition parameters to the region to be created are passed in this Description pos -The corner of the screen to place the status display - in. One of tl, tr, bl or br. +(string) The corner of the screen to place the status + display in: one of `tl', `tr', `bl' + or `br'. + +fullsize +(boolean) Waste all available space. action -If this field is set to keep, corner - and orientation are changed for the existing - status display. If this field is set to remove, +(string) If this field is set to `keep', + pos and fullsize are changed for the existing + status display. If this field is set to `remove', the existing status display is removed. If this - field is not set or is set to replace, a + field is not set or is set to `replace', a new status display is created and the old, if any, removed. @@ -2658,9 +2679,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMPlex.switch_next(WMPlex mplex) @@ -2676,9 +2695,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMPlex.switch_nth(WMPlex mplex, integer n) @@ -2693,9 +2710,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMPlex.switch_prev(WMPlex mplex) @@ -2710,16 +2725,14 @@ In addition parameters to the region to be created are passed in this

-

-6.1.8 WMoveresMode functions +

+6.1.9 WMoveresMode functions

-
- - +
Synopsis:
void WMoveresMode.cancel(WMoveresMode mode) @@ -2735,9 +2748,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMoveresMode.finish(WMoveresMode mode) @@ -2753,9 +2764,22 @@ In addition parameters to the region to be created are passed in this

-
- - +
+
+
Synopsis:
+
table WMoveresMode.geom(WMoveresMode mode) + +
+
Description:
+
Returns current geometry. + +
+
+ +

+ +

+
Synopsis:
void WMoveresMode.move(WMoveresMode mode, integer horizmul, integer vertmul) @@ -2786,9 +2810,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
void WMoveresMode.resize(WMoveresMode mode, integer left, integer right, integer top, integer bottom) @@ -2805,16 +2827,30 @@ In addition parameters to the region to be created are passed in this

-

-6.1.9 WRegion functions +
+
+
+
Synopsis:
+
table WMoveresMode.rqgeom(WMoveresMode mode, table g) + +
+
Description:
+
Request exact geometry in move/resize mode. For details on parameters, + see WRegion.rqgeom. + +
+
+ +

+ +

+6.1.10 WRegion functions

-
- - +
Synopsis:
WMoveresMode WRegion.begin_kbresize(WRegion reg) @@ -2834,16 +2870,14 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
WRegion WRegion.current(WRegion mgr)
Description:
-
Return the object, if any, that is considered ''currently active'' +
Return the object, if any, that is considered ``currently active'' within the objects managed by mplex.
@@ -2852,9 +2886,7 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
table WRegion.geom(WRegion reg) @@ -2870,21 +2902,15 @@ In addition parameters to the region to be created are passed in this

-
- - +
Synopsis:
-
bool WRegion.goto(WRegion reg) +
table WRegion.get_configuration(WRegion reg, bool clientwins)
Description:
-
Attempt to display reg, save region activity status and then - warp to (or simply set focus to if warping is disabled) reg. - -

-Note that this function is asynchronous; the region will not - actually have received the focus when this function returns. +

Get configuration tree. If clientwins is unset, client windows + are filtered out.
@@ -2892,16 +2918,50 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
bool WRegion.is_active(WRegion reg) +
bool WRegion.goto(WRegion reg)
Description:
-
Is reg active/does it or one of it's children of focus? +
Attempt to display reg, save region activity status and then + warp to (or simply set focus to if warping is disabled) reg. + +

+Note that this function is asynchronous; the region will not + actually have received the focus when this function returns. + +

+
+ +

+ +

+
+
+
Synopsis:
+
WRegion WRegion.groupleader_of(WRegion reg) + +
+
Description:
+
Returns the group of reg, if reg is its bottom, + and reg itself otherwise. + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool WRegion.is_active(WRegion reg, bool pseudoact_ok) + +
+
Description:
+
Is reg active/does it or one of it's children of focus?
@@ -2909,9 +2969,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.is_activity(WRegion reg) @@ -2926,9 +2984,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.is_mapped(WRegion reg) @@ -2943,9 +2999,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.is_tagged(WRegion reg) @@ -2960,9 +3014,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion WRegion.manager(WRegion reg) @@ -2977,9 +3029,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string WRegion.name(WRegion reg) @@ -2994,9 +3044,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WWindow WRegion.parent(WRegion reg) @@ -3011,9 +3059,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRootWin WRegion.rootwin_of(WRegion reg) @@ -3028,12 +3074,10 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
bool WRegion.rqclose(WRegion reg, bool relocate) +
void WRegion.rqclose(WRegion reg, bool relocate)
Description:
@@ -3041,12 +3085,11 @@ Note that this function is asynchronous; the region will not depends on whether the particular type of region in question has implemented the feature and, in case of client windows, whether the client supports the WM_DELETE protocol (see also - WClientWin.kill). If the operation is likely to succeed, - true is returned, otherwise false. In most cases the - region will not have been actually destroyed when this function returns. - If relocate is not set, and reg manages other regions, it - will not be closed. Otherwise the managed regions will be attempted - to be relocated. + WClientWin.kill). The region will not be destroyed when + this function returns. To find out if and when it is destroyed, + use the `deinit' notification. If relocate is not set, + and reg manages other regions, it will not be closed. Otherwise + the managed regions will be attempted to be relocated.
@@ -3054,9 +3097,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion WRegion.rqclose_propagate(WRegion reg, WRegion maybe_sub) @@ -3066,8 +3107,8 @@ Note that this function is asynchronous; the region will not
Recursively attempt to close a region or one of the regions managed by it. If sub is set, it will be used as the managed region, otherwise WRegion.current(reg). The object to be closed is - returned or NULL if nothing can be closed. Also see notes for - WRegion.rqclose. + returned, or NULL if nothing can be closed. For further details, see + notes for WRegion.rqclose.
@@ -3075,9 +3116,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table WRegion.rqgeom(WRegion reg, table g) @@ -3095,9 +3134,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.rqorder(WRegion reg, string ord) @@ -3105,7 +3142,7 @@ Note that this function is asynchronous; the region will not
Description:
Request ordering. Currently supported values for ord - are 'front' and 'back'. + are `front' and `back'.
@@ -3113,9 +3150,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WScreen WRegion.screen_of(WRegion reg) @@ -3130,17 +3165,15 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.set_activity(WRegion reg, string how)
Description:
-
Set activity flag of reg. The how parameter most be - one of (set/unset/toggle). +
Set activity flag of reg. The how parameter must be + one of `set', `unset' or `toggle'.
@@ -3148,9 +3181,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.set_name(WRegion reg, string p) @@ -3158,7 +3189,7 @@ Note that this function is asynchronous; the region will not
Description:
Set the name of reg to p. If the name is already in use, - an instance number suffix <n> will be attempted. If p has + an instance number suffix `<n>' will be attempted. If p has such a suffix, it will be modified, otherwise such a suffix will be added. Setting p to nil will cause current name to be removed. @@ -3168,9 +3199,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.set_name_exact(WRegion reg, string p) @@ -3179,7 +3208,7 @@ Note that this function is asynchronous; the region will not
Description:
Similar to WRegion.set_name except if the name is already in use, other instance numbers will not be attempted. The string p should - not contain a <n> suffix or this function will fail. + not contain a `<n>' suffix or this function will fail.
@@ -3187,9 +3216,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WRegion.set_tagged(WRegion reg, string how) @@ -3197,7 +3224,8 @@ Note that this function is asynchronous; the region will not
Description:
Change tagging state of reg as defined by how - (set/unset/toggle). Resulting state is returned. + (one of `set', `unset', or `toggle'). + The resulting state is returned.
@@ -3205,9 +3233,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table WRegion.size_hints(WRegion reg) @@ -3223,16 +3249,14 @@ Note that this function is asynchronous; the region will not

-

-6.1.10 WRootWin functions +

+6.1.11 WRootWin functions

-
- - +
Synopsis:
WScreen WRootWin.current_scr(WRootWin rootwin) @@ -3246,16 +3270,14 @@ Note that this function is asynchronous; the region will not

-

-6.1.11 WScreen functions +

+6.1.12 WScreen functions

-
- - +
Synopsis:
integer WScreen.id(WScreen scr) @@ -3270,9 +3292,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WScreen.set_managed_offset(WScreen scr, table offset) @@ -3289,16 +3309,65 @@ Note that this function is asynchronous; the region will not

-

-6.1.12 WWindow functions +

+6.1.13 WTimer functions +

+ +

+ +

+
+
+
Synopsis:
+
bool WTimer.is_set(WTimer timer) + +
+
Description:
+
Is timer set? + +
+
+ +

+ +

+
+
+
Synopsis:
+
void WTimer.reset(WTimer timer) + +
+
Description:
+
Reset timer. + +
+
+ +

+ +

+
+
+
Synopsis:
+
void WTimer.set(WTimer timer, integer msecs, function fn) + +
+
Description:
+
Set timer to call fn in msecs milliseconds. + +
+
+ +

+ +

+6.1.14 WWindow functions

-
- - +
Synopsis:
void WWindow.p_move(WWindow wwin) @@ -3315,9 +3384,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WWindow.p_resize(WWindow wwin) @@ -3334,9 +3401,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
double WWindow.xid(WWindow wwin) @@ -3350,15 +3415,14 @@ Note that this function is asynchronous; the region will not

-

-6.1.13 global functions +

+6.1.15 global functions

-
- +
Synopsis:
export(lib, ...) @@ -3372,23 +3436,21 @@ Note that this function is asynchronous; the region will not

-

-6.1.14 gr functions +

+6.1.16 gr functions

-
- - +
Synopsis:
void gr.read_config()
Description:
-
Read drawing engine configuration file draw.lua. +
Read drawing engine configuration file look.lua.
@@ -3396,9 +3458,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void gr.refresh() @@ -3413,16 +3473,14 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool gr.select_engine(string engine)
Description:
-
Future requests for ''brushes'' are to be forwarded to the drawing engine +
Future requests for ``brushes'' are to be forwarded to the drawing engine engine. If no engine of such name is known, a module with that name is attempted to be loaded. This function is only intended to be called from colour scheme etc. configuration files and can not be used to change the @@ -3433,16 +3491,14 @@ Note that this function is asynchronous; the region will not

-

-6.1.15 string functions +

+6.1.17 string functions

-
- - +
Synopsis:
string.shell_safe(str) @@ -3456,16 +3512,14 @@ Note that this function is asynchronous; the region will not

-

-6.1.16 table functions +

+6.1.18 table functions

-
- - +
Synopsis:
table.append(t1, t2) @@ -3480,9 +3534,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table.copy(t, deep) @@ -3498,9 +3550,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table.icat(t1, t2) @@ -3515,9 +3565,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table.join(t1, t2) @@ -3533,9 +3581,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table.map(f, t) @@ -3556,9 +3602,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table mod_tiling.get() @@ -3573,9 +3617,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool mod_tiling.mkbottom(WRegion reg) @@ -3591,9 +3633,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void mod_tiling.set(table tab) @@ -3606,6 +3646,22 @@ Note that this function is asynchronous; the region will not
+

+ +

+
+
+
Synopsis:
+
bool mod_tiling.untile(WTiling tiling) + +
+
Description:
+
If tiling is managed by some group, float the frames in + the tiling in that group, and dispose of tiling. + +
+
+

@@ -3615,9 +3671,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table WSplit.geom(WSplit split) @@ -3632,9 +3686,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplitInner WSplit.parent(WSplit split) @@ -3649,9 +3701,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table WSplit.rqgeom(WSplit node, table g) @@ -3668,9 +3718,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WSplit.transpose(WSplit node) @@ -3691,9 +3739,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplit WSplitInner.current(WSplitInner node) @@ -3714,9 +3760,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion WSplitRegion.reg(WSplitRegion node) @@ -3737,9 +3781,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplit WSplitSplit.br(WSplitSplit split) @@ -3755,17 +3797,15 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string WSplitSplit.dir(WSplitSplit split)
Description:
-
Returns the direction of split; either ''vertical'' or - ''horizontal''. +
Returns the direction of split; either `vertical' or + `horizontal'.
@@ -3773,16 +3813,14 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WSplitSplit.flip(WSplitSplit split)
Description:
-
Flip contents of node. +
Flip contents of split.
@@ -3790,9 +3828,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplit WSplitSplit.tl(WSplitSplit split) @@ -3814,9 +3850,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WTiling.flip_at(WTiling ws, WRegion reg) @@ -3831,9 +3865,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WTiling.transpose_at(WTiling ws, WRegion reg) @@ -3848,9 +3880,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion WTiling.farthest(WTiling ws, string dirstr, bool any) @@ -3859,8 +3889,8 @@ Note that this function is asynchronous; the region will not
Description:
Return the most previously active region on ws with no other regions next to it in direction dirstr - (left/right/up/down). If any is not set, the status - display is not considered. + (`left', `right', `up', or `down'). + If any is not set, the status display is not considered.
@@ -3868,9 +3898,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WTiling.managed_i(WTiling ws, function iterfn) @@ -3879,7 +3907,8 @@ Note that this function is asynchronous; the region will not
Description:
Iterate over managed regions of ws until iterfn returns false. - The function itself returns true if it reaches the end of list + The function is called in protected mode. + This routine returns true if it reaches the end of list without this happening.
@@ -3888,9 +3917,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WRegion WTiling.nextto(WTiling ws, WRegion reg, string dirstr, bool any) @@ -3898,7 +3925,8 @@ Note that this function is asynchronous; the region will not
Description:
Return the most previously active region next to reg in - direction dirstr (left/right/up/down). The region reg + direction dirstr (`left', `right', `up', + or `down'). The region reg must be managed by ws. If any is not set, the status display is not considered. @@ -3908,9 +3936,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplitRegion WTiling.node_of(WTiling ws, WRegion reg) @@ -3926,9 +3952,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WTiling.set_floating_at(WTiling ws, WRegion reg, string how, string dirstr) @@ -3936,9 +3960,10 @@ Note that this function is asynchronous; the region will not
Description:
Toggle floating of the sides of a split containin reg as indicated - by the parameters how (set/unset/toggle) and dirstr - (left/right/up/down/any). The new status is returned (and false - also on error). + by the parameters how (`set', `unset', or + `toggle') and dirstr (`left', `right', + `up', or `down'). The new status is returned + (and false also on error).
@@ -3946,9 +3971,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplitSplit WTiling.set_floating(WTiling ws, WSplitSplit split, string how) @@ -3956,8 +3979,8 @@ Note that this function is asynchronous; the region will not
Description:
Toggle floating of a split's sides at split as indicated by the - parameter how (set/unset/toggle). A split of the appropriate is - returned, if there was a change. + parameter how (`set', `unset', or `toggle'). + A split of the appropriate is returned, if there was a change.
@@ -3965,18 +3988,17 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WFrame WTiling.split(WTiling ws, WSplit node, string dirstr)
Description:
-
Create a new frame on ws above/below/left of/right of - node as indicated by dirstr. If dirstr is - prefixed with ''floating:'' a floating split is created. +
Create a new frame on ws `above', `below' + `left' of, or `right' of node as indicated + by dirstr. If dirstr is prefixed with + `floating:' a floating split is created.
@@ -3984,9 +4006,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WFrame WTiling.split_at(WTiling ws, WFrame frame, string dirstr, bool attach_current) @@ -3994,11 +4014,12 @@ Note that this function is asynchronous; the region will not
Description:
Split frame creating a new frame to direction dirstr - (one of ''left'', ''right'', ''top'' or ''bottom'') of frame. + (one of `left', `right', `top' or + `bottom') of frame. If attach_current is set, the region currently displayed in frame, if any, is moved to thenew frame. - If dirstr is prefixed with ''floating:'' a floating split is - created. + If dirstr is prefixed with `floating:', a floating + split is created.
@@ -4006,9 +4027,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WFrame WTiling.split_top(WTiling ws, string dirstr) @@ -4023,9 +4042,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
WSplit WTiling.split_tree(WTiling ws) @@ -4040,17 +4057,15 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
bool WTiling.unsplit_at(WTiling ws, WFrame frame) +
void WTiling.unsplit_at(WTiling ws, WRegion reg)
Description:
-
Try to relocate regions managed by frame to another frame - and, if possible, destroy the frame. +
Try to relocate regions managed by reg to another frame + and, if possible, destroy it.
@@ -4064,9 +4079,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.defcmd(cmd, fn) @@ -4081,9 +4094,22 @@ Note that this function is asynchronous; the region will not

-
- - +
+
+
Synopsis:
+
mod_query.message(mplex, str) + +
+
Description:
+
Display a message in mplex. + +
+
+ +

+ +

+
Synopsis:
table mod_query.get() @@ -4099,9 +4125,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void mod_query.history_clear() @@ -4116,9 +4140,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string mod_query.history_get(integer n) @@ -4133,9 +4155,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool mod_query.history_push(string str) @@ -4150,9 +4170,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
integer mod_query.history_search(string s, integer from, bool bwd, bool exact) @@ -4171,9 +4189,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
table mod_query.history_table() @@ -4188,26 +4204,7 @@ Note that this function is asynchronous; the region will not

-
- - -
-
Synopsis:
-
WMessage mod_query.message(WMPlex mplex, string p) - -
-
Description:
-
Display a message in the mplex. - -
-
- -

- -

-
- - +
Synopsis:
void mod_query.set(table tab) @@ -4233,6 +4230,10 @@ Note that this function is asynchronous; the region will not (boolean) Turn some completions case-insensitive (default: false). +substrcompl +(boolean) Complete on sub-strings in some cases + (default: ftrue). +
@@ -4241,36 +4242,18 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
WMessage mod_query.warn(WMPlex mplex, string p) - -
-
Description:
-
Display an error message box in the multiplexer mplex. - -
-
- -

- -

-
- - -
-
Synopsis:
-
mod_query.popen_completions(cp, cmd, fn, reshnd) +
mod_query.popen_completions(cp, cmd, fn, reshnd, wd)
Description:
This function can be used to read completions from an external source. The parameter cp is the completion proxy to be used, - and the string cmd the shell command to be executed. To its stdout, - the command should on the first line write the common_beg + and the string cmd the shell command to be executed, in the directory + wd. + To its stdout, the command should on the first line write the common_beg parameter of WComplProxy.set_completions (which fn maybe used to override) and a single actual completion on each of the successive lines. The function reshnd may be used to override a result table @@ -4282,9 +4265,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query(mplex, prompt, initvalue, handler, completor, @@ -4309,18 +4290,16 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_attachclient(mplex)
Description:
-
This query asks for the name of a client window and switches - focus to the one entered. It uses the completion function - ioncore.complete_clientwin. +
This query asks for the name of a client window and attaches + it to the frame the query was opened in. It uses the completion + function ioncore.complete_clientwin.
@@ -4328,9 +4307,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_editfile(mplex, script, prompt) @@ -4347,9 +4324,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_exec(mplex) @@ -4368,18 +4343,16 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_gotoclient(mplex)
Description:
-
This query asks for the name of a client window and attaches - it to the frame the query was opened in. It uses the completion - function ioncore.complete_clientwin. +
This query asks for the name of a client window and switches + focus to the one entered. It uses the completion function + ioncore.complete_clientwin.
@@ -4387,9 +4360,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_lua(mplex) @@ -4407,9 +4378,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_man(mplex, prog) @@ -4426,12 +4395,10 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
-
mod_query.query_menu(mplex, themenu, prompt) +
mod_query.query_menu(mplex, sub, themenu, prompt)
Description:
@@ -4443,9 +4410,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_renameframe(frame) @@ -4461,9 +4426,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_renameworkspace(mplex, ws) @@ -4480,9 +4443,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_restart(mplex) @@ -4498,9 +4459,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_runfile(mplex, script, prompt) @@ -4517,9 +4476,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_shutdown(mplex) @@ -4536,9 +4493,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_ssh(mplex, ssh) @@ -4554,9 +4509,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_workspace(mplex) @@ -4575,9 +4528,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.query_yesno(mplex, prompt, handler) @@ -4594,9 +4545,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.show_about_ion(mplex) @@ -4611,9 +4560,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
mod_query.show_tree(mplex, reg, max_depth) @@ -4625,6 +4572,21 @@ Note that this function is asynchronous; the region will not
+

+ +

+
+
+
Synopsis:
+
mod_query.warn(mplex, str) + +
+
Description:
+
Display an error message box in the multiplexer mplex. + +
+
+

@@ -4634,9 +4596,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WComplProxy.set_completions(WComplProxy proxy, table compls) @@ -4661,9 +4621,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.back(WEdln wedln) @@ -4678,9 +4636,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.backspace(WEdln wedln) @@ -4695,9 +4651,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.bkill_word(WEdln wedln) @@ -4713,9 +4667,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.bol(WEdln wedln) @@ -4730,9 +4682,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.bskip_word(WEdln wedln) @@ -4748,9 +4698,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.clear_mark(WEdln wedln) @@ -4765,9 +4713,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.complete(WEdln wedln, string cycle, string mode) @@ -4776,11 +4722,12 @@ Note that this function is asynchronous; the region will not
Description:
Call completion handler with the text between the beginning of line and current cursor position, or select next/previous completion from list if in - auto-show-completions mode and cycle is set to ``next'' or ``prev'', - respectively. The mode may be ``history'' or ``normal''. If it is + auto-show-completions mode and cycle is set to `next' or + `prev', respectively. + The mode may be `history' or `normal'. If it is not set, the previous mode is used. Normally next entry is not cycled to despite the setting of cycle if mode switch occurs. To override - this, use ``next-always'' and ``prev-always'' for cycle. + this, use `next-always' and `prev-always' for cycle.
@@ -4788,9 +4735,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string WEdln.contents(WEdln wedln) @@ -4805,9 +4750,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
string WEdln.context(WEdln wedln) @@ -4822,9 +4765,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.copy(WEdln wedln) @@ -4839,9 +4780,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.cut(WEdln wedln) @@ -4857,9 +4796,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.delete(WEdln wedln) @@ -4874,9 +4811,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.eol(WEdln wedln) @@ -4891,9 +4826,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.finish(WEdln wedln) @@ -4908,9 +4841,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.forward(WEdln wedln) @@ -4925,9 +4856,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.history_next(WEdln wedln, bool match) @@ -4944,9 +4873,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.history_prev(WEdln wedln, bool match) @@ -4963,9 +4890,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.insstr(WEdln wedln, string str) @@ -4980,9 +4905,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WEdln.is_histcompl(WEdln wedln) @@ -4997,9 +4920,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.kill_line(WEdln wedln) @@ -5014,9 +4935,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.kill_to_bol(WEdln wedln) @@ -5031,9 +4950,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.kill_to_eol(WEdln wedln) @@ -5048,9 +4965,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.kill_word(WEdln wedln) @@ -5066,9 +4981,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
integer WEdln.mark(WEdln wedln) @@ -5085,9 +4998,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
bool WEdln.next_completion(WEdln wedln) @@ -5102,9 +5013,7 @@ Note that this function is asynchronous; the region will not

-
- - +
Synopsis:
void WEdln.paste(WEdln wedln) @@ -5124,9 +5033,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
integer WEdln.point(WEdln wedln) @@ -5142,9 +5049,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
bool WEdln.prev_completion(WEdln wedln) @@ -5159,9 +5064,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WEdln.set_context(WEdln wedln, string context) @@ -5176,9 +5079,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WEdln.set_mark(WEdln wedln) @@ -5193,9 +5094,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WEdln.skip_word(WEdln wedln) @@ -5211,9 +5110,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WEdln.transpose_chars(WEdln wedln) @@ -5228,9 +5125,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WEdln.transpose_words(WEdln wedln) @@ -5251,9 +5146,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WInput.cancel(WInput input) @@ -5268,9 +5161,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WInput.scrolldown(WInput input) @@ -5285,9 +5176,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WInput.scrollup(WInput input) @@ -5308,9 +5197,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
mod_menu.grabmenu(mplex, sub, menu_or_name, param) @@ -5327,9 +5214,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
mod_menu.menu(mplex, sub, menu_or_name, param) @@ -5354,9 +5239,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
table mod_menu.get() @@ -5371,9 +5254,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void mod_menu.set(table tab) @@ -5406,9 +5287,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
mod_menu.pmenu(win, sub, menu_or_name) @@ -5431,9 +5310,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.cancel(WMenu menu) @@ -5448,9 +5325,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.finish(WMenu menu) @@ -5466,9 +5341,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.select_next(WMenu menu) @@ -5483,9 +5356,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.select_nth(WMenu menu, integer n) @@ -5500,9 +5371,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.select_prev(WMenu menu) @@ -5517,9 +5386,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WMenu.typeahead_clear(WMenu menu) @@ -5540,9 +5407,7 @@ Note that this function is asynchronous; the selection will not
-
- - +
Synopsis:
void mod_dock.set_floating_shown_on(WMPlex mplex, string how) @@ -5563,9 +5428,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
bool WDock.attach(WDock dock, WRegion reg) @@ -5580,9 +5443,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
table WDock.get(WDock dock) @@ -5598,9 +5459,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WDock.resize(WDock dock) @@ -5615,9 +5474,7 @@ Note that this function is asynchronous; the selection will not

-
- - +
Synopsis:
void WDock.set(WDock dock, table conftab) @@ -5640,7 +5497,10 @@ Note that this function is asynchronous; the selection will not string in - +$\{t,m,b\}\times\{t,c,b\}$ Dock position. Can only be used in floating mode. @@ -5671,9 +5531,7 @@ Any parameters not explicitly set in conftab will be left unchanged.
-
- - +
Synopsis:
bool mod_sp.set_shown(WFrame sp, string how) @@ -5681,7 +5539,9 @@ Any parameters not explicitly set in conftab will be left unchanged.
Description:
Toggle displayed status of sp. - The parameter how is one of (set/unset/toggle). + The parameter how is one of + `set', `unset', or `toggle'. + The resulting status is returned.
@@ -5689,9 +5549,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

-
- - +
Synopsis:
bool mod_sp.set_shown_on(WMPlex mplex, string how) @@ -5699,7 +5557,9 @@ Any parameters not explicitly set in conftab will be left unchanged.
Description:
Change displayed status of some scratchpad on mplex if one is - found. The parameter how is one of (set/unset/toggle). + found. The parameter how is one of + `set', `unset', or `toggle'. + The resulting status is returned.
@@ -5707,15 +5567,230 @@ Any parameters not explicitly set in conftab will be left unchanged.

+ +
+6.7 Functions defined in mod_statusbar +

+ +
+
+
+
Synopsis:
+
mod_statusbar.create(param) + +
+
Description:
+
Create a statusbar. The possible parameters in the + table param are: + +

+ + + + + + + + + + + + + + + + + + + + + + + + + +
VariableTypeDescription
templatestringThe template; see + Section 3.6.
posstringPosition: `tl', `tr', + `bl' or `br' + (for the obvious combinations of + top/left/bottom/right).
screenintegerScreen number to create the statusbar on.
fullsizebooleanIf set, the statusbar will waste + space instead of adapting to layout.
systrayboolaenSwallow (KDE protocol) systray icons.
+ +

+
+ +

+ +

+
+
+
Synopsis:
+
mod_statusbar.inform(name, value) + +
+
Description:
+
Inform of a value. + +
+
+ +

+ +

+
+
+
Synopsis:
+
mod_statusbar.launch_statusd(cfg) + +
+
Description:
+
Load modules and launch ion-statusd with configuration + table cfg. The options for each ion-statusd monitor + script should be contained in the corresponding sub-table of cfg. + +
+
+ +

+ +

+
+
+
Synopsis:
+
table mod_statusbar.statusbars() + +
+
Description:
+
Returns a list of all statusbars. + +
+
+ +

+ +

+
+
+
Synopsis:
+
mod_statusbar.update(update_templates) + +
+
Description:
+
Update statusbar contents. To be called after series + of mod_statusbar.inform calls. + +
+
+ +

+ +

+6.7.1 WStatusBar functions +

+ +

+ +

+
+
+
Synopsis:
+
table WStatusBar.get_template_table(WStatusBar sb) + +
+
Description:
+
Get statusbar template as table. + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool WStatusBar.is_systray(WStatusBar sb) + +
+
Description:
+
Is sb used as a systray? + +
+
+ +

+ +

+
+
+
Synopsis:
+
bool WStatusBar.set_systray(WStatusBar sb, string how) + +
+
Description:
+
Enable or disable use of sb as systray. + The parameter how can be one of + `set', `unset', or `toggle'. + Resulting state is returned. + +
+
+ +

+ +

+
+
+
Synopsis:
+
void WStatusBar.set_template(WStatusBar sb, string tmpl) + +
+
Description:
+
Set statusbar template. + +
+
+ +

+ +

+
+
+
Synopsis:
+
void WStatusBar.set_template_table(WStatusBar sb, table t) + +
+
Description:
+
Set statusbar template as table. + +
+
+ +

+ +

+
+
+
Synopsis:
+
void WStatusBar.update(WStatusBar sb, table t) + +
+
Description:
+
Set statusbar template. + +
+
+ +

+ +


-6.7 Functions defined in de +6.8 Functions defined in de

-
- - +
Synopsis:
bool de.defstyle(string name, table tab) @@ -5730,9 +5805,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

-
- - +
Synopsis:
bool de.defstyle_rootwin(WRootWin rootwin, string name, table tab) @@ -5747,9 +5820,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

-
- - +
Synopsis:
void de.reset() @@ -5764,9 +5835,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

-
- - +
Synopsis:
table de.substyle(string pattern, table tab) @@ -5780,16 +5849,16 @@ Any parameters not explicitly set in conftab will be left unchanged.

-

+


-6.8 Hooks +6.9 Hooks

-
+
Hook name:
@@ -5824,7 +5893,7 @@ Any parameters not explicitly set in conftab will be left unchanged. dockapp bool -Client window is a dockapp. +Client window is a dock-app. maprq bool @@ -5861,7 +5930,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5881,7 +5950,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5902,7 +5971,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5923,7 +5992,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5950,12 +6019,12 @@ reg:attach(cwin) mode string -"switchonly", "reorder", - "add" or "remove" +`switchonly', `reorder', + `add' or `remove' sw bool -Switch occured +Switch occurred sub WRegion @@ -5969,7 +6038,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -5990,7 +6059,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6010,7 +6079,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6023,7 +6092,7 @@ reg:attach(cwin)
Description:
Called when Ion has done all initialisation and is almost ready to - enter the mainloop, except no windows are yet being managed. + enter the main-loop, except no windows are yet being managed.
@@ -6031,7 +6100,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6051,7 +6120,27 @@ reg:attach(cwin)

-
+
+ +
+
Hook name:
+
ioncore_submap_ungrab_hook + +
+
Parameters:
+
() + +
+
Description:
+
This hook is used to signal whenever Ion leaves the submap grab mode. + +
+
+ +

+ +

+
Hook name:
@@ -6087,7 +6176,7 @@ reg:attach(cwin) res_frame WFrame -A succesfull handler should +A successful handler should return the target frame here. @@ -6103,7 +6192,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6124,7 +6213,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6146,7 +6235,7 @@ reg:attach(cwin)

-
+
Hook name:
@@ -6195,16 +6284,16 @@ reg:attach(cwin) Tagging state has changed. pseudoactivated -The region has become pseudoactive +The region has become pseudo-active (see below). pseudoinactivated -The region is no longer pseudoactive. +The region is no longer pseudo-active.

-A region is pseudoactive, when a) it is itself not active (does +A region is pseudo-active, when a) it is itself not active (does not not have the focus, and may not even have a window that could have it), but b) some region managed by it is active. @@ -6215,35 +6304,96 @@ A region is pseudoactive, when a) it is itself not active (does

+

+ +
+6.10 Miscellaneous +

+ +

+ +

+ +
+6.10.1 Size policies +

+ +

+Some functions accept a sizepolicy parameter. The possible +values are: + +

+

+`default', +`full', +`full_bounds', +`free', +`free_glue', +`northwest', +`north', +`northeast', +`west', +`center', +`east', +`southwest', +`south', +`southeast', +`stretch_top', +`stretch_bottom', +`stretch_left', +`stretch_right', +`free_glue_northwest', +`free_glue_north', +`free_glue_northeast', +`free_glue_west', +`free_glue_center', +`free_glue_east', +`free_glue_southwest', +`free_glue_south', and +`free_glue_southeast'. + +
+ +

+The ``free'' policies allow the managed +object to be moved around, whereas the other versions do not. +The ``glue'' policies glue the object to some border, while allowing +it to be moved away from it by user action, but not automatically. +The ``stretch'' policies stretch the object along the given border, +while the coordinate-based policies simply place the object along +that border. + +

+

- next - up - previous - contents - index
- Next: A. The GNU General - Up: Next: A. GNU Free Documentation + Up: Configuring and extending Ion3 - Previous: Previous: 5. Scripting -   Contents -   Index