X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=ionconf%2Fnode7.html;h=f4a93eec1e36ae429f5f212070609b98eda73969;hb=428266c577f55bd77cf036ed0d2af379613471e4;hp=9b8b3e3d8db7d7e16466be2f186f92927422364a;hpb=a35ba2541b8601953ae94f779a85ae70de19cd11;p=ion3-doc.git diff --git a/ionconf/node7.html b/ionconf/node7.html index 9b8b3e3..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,97 +61,106 @@ original version by: Nikos Drakos, CBLU, University of Leeds Subsections +
  • 6.10 Miscellaneous +
    @@ -170,9 +179,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds
    -
    - - +
    Synopsis:
    ioncore.TR(s, ...) @@ -187,9 +194,7 @@ original version by: Nikos Drakos, CBLU, University of Leeds

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

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

    -
    - - +
    Synopsis:
    ioncore.compile_cmd(cmd, guard) @@ -249,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) @@ -268,9 +282,7 @@ The string guard maybe set to pose limits on _sub. Currently

    -
    - - +
    Synopsis:
    ioncore.defbindings(context, bindings) @@ -279,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.
    @@ -287,9 +299,7 @@ The string guard maybe set to pose limits on _sub. Currently

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    string ioncore.aboutmsg() @@ -592,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.
    @@ -609,9 +585,7 @@ The string guard maybe set to pose limits on _sub. Currently

    -
    - - +
    Synopsis:
    bool ioncore.activity_i(function iterfn) @@ -619,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.
    @@ -628,9 +603,7 @@ The string guard maybe set to pose limits on _sub. Currently

    -
    - - +
    Synopsis:
    bool ioncore.clientwin_i(function fn) @@ -638,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.
    @@ -647,9 +621,7 @@ The string guard maybe set to pose limits on _sub. Currently

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

    -
    - - +
    Synopsis:
    bool ioncore.defshortening(string rx, string rule, bool always) @@ -718,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.

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

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

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

    -
    - - +
    Synopsis:
    bool ioncore.focushistory_i(function iterfn) @@ -789,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.
    @@ -798,9 +766,7 @@ Similarly to sed's 's' command, rule may contain characters that are

    -
    - - +
    Synopsis:
    table ioncore.get() @@ -815,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).
    @@ -832,9 +797,7 @@ Similarly to sed's 's' command, rule may contain characters that are

    -
    - - +
    Synopsis:
    bool ioncore.goto_activity() @@ -849,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.
    @@ -870,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.
    @@ -891,9 +848,7 @@ Similarly to sed's 's' command, rule may contain characters that are

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    WRegion ioncore.lookup_region(string name, string typenam) @@ -1044,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.
    @@ -1063,9 +1001,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    WRegion ioncore.navi_next(WRegion reg, string dirstr, table param) @@ -1073,8 +1009,9 @@ 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 boolean functions ascend_filter and descend_filter on WRegion pairs (to, from), are used to decide when @@ -1086,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.
    @@ -1105,9 +1043,7 @@ Note that this function is asynchronous; the region will not

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

    -
    - - +
    Synopsis:
    bool ioncore.region_i(function fn, string typenam) @@ -1133,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.
    @@ -1142,9 +1077,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

    -
    - - +
    Synopsis:
    void ioncore.set(table tab) @@ -1250,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). @@ -1274,16 +1200,21 @@ 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: ''disable'' or ''sloppy''. +(string) Mouse focus mode: + `disable' or `sloppy'. unsqueeze (boolean) Auto-unsqueeze transients/menus/queries/etc. @@ -1308,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).
    @@ -1325,9 +1255,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

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

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

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

    -
    - - +
    Synopsis:
    void ioncore.tagged_clear() @@ -1393,16 +1315,14 @@ When a keyboard resize function is called, and at most kbresize_t_max

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

    -
    - - +
    Synopsis:
    bool ioncore.tagged_i(function iterfn) @@ -1420,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.
    @@ -1429,9 +1348,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    void ioncore.unsqueeze(WRegion reg, bool override) @@ -1449,9 +1366,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

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

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

    -
    - - +
    Synopsis:
    void ioncore.warn_traced(string str) @@ -1501,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) @@ -1511,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. @@ -1521,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) @@ -1538,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) @@ -1556,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. @@ -1576,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) @@ -1598,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) @@ -1615,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) @@ -1634,9 +1530,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    ioncore.kpress(keyspec, cmd, guard) @@ -1644,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.
    @@ -1653,19 +1548,17 @@ 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.
    @@ -1673,12 +1566,40 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    -
    ioncore.match_winprop_name(prop, cwin) +
    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. + +
    +
    + +

    + +

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

    -
    - - +
    Synopsis:
    ioncore.mclick(buttonspec, cmd, guard) @@ -1701,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.
    @@ -1710,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.
    @@ -1728,9 +1645,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

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

    -
    - - +
    Synopsis:
    ioncore.menuentry(name, cmd, guard_or_opts) @@ -1773,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.
    @@ -1791,9 +1702,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    ioncore.refresh_stylelist() @@ -1808,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.
    @@ -1828,9 +1765,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    ioncore.submenu(name, sub_or_name, options) @@ -1851,9 +1786,40 @@ 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) @@ -1864,6 +1830,8 @@ When a keyboard resize function is called, and at most kbresize_t_max 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.
    @@ -1877,9 +1845,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

    -
    - - +
    Synopsis:
    table WClientWin.get_ident(WClientWin cwin) @@ -1897,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.
    @@ -1915,9 +1879,7 @@ When a keyboard resize function is called, and at most kbresize_t_max

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

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    void WFrame.p_tabdrag(WFrame frame) @@ -2070,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'.
    @@ -2078,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'.
    @@ -2095,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').
    @@ -2114,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) @@ -2124,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.
    @@ -2139,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) @@ -2158,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) @@ -2176,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. @@ -2205,33 +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. - -
    -
    - -

    - -

    -
    - - -
    -
    Synopsis:
    -
    bool WGroup.is_fullscreen(WGroup grp) - -
    -
    Description:
    -
    Is reg in full screen mode? +
    Returns the `bottom' of ws.
    @@ -2239,9 +2163,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    bool WGroup.managed_i(WGroup ws, function iterfn) @@ -2250,7 +2172,8 @@ In addition parameters to the region to be created are passed in this
    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.
    @@ -2259,16 +2182,14 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    bool WGroup.set_bottom(WGroup ws, WRegion reg)
    Description:
    -
    Sets the 'bottom' of ws. The region reg must already +
    Sets the `bottom' of ws. The region reg must already be managed by ws, unless nil.
    @@ -2277,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) @@ -2287,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.
    @@ -2308,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) @@ -2341,15 +2259,66 @@ In addition parameters to the region to be created are passed in this

    -6.1.6 WInfoWin functions +6.1.6 WHook functions

    -
    - - +
    +
    +
    Synopsis:
    +
    bool WHook.add(WHook hk, function efn) + +
    +
    Description:
    +
    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. + +
    +
    + +

    + +

    +6.1.7 WInfoWin functions +

    + +

    + +

    +
    Synopsis:
    void WInfoWin.set_text(WInfoWin p, string str, integer maxw) @@ -2363,16 +2332,14 @@ In addition parameters to the region to be created are passed in this

    -

    -6.1.7 WMPlex functions +

    +6.1.8 WMPlex functions

    -
    - - +
    Synopsis:
    WRegion WMPlex.attach(WMPlex mplex, WRegion reg, table param) @@ -2389,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) @@ -2434,8 +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. +(string) Size policy; see Section 6.10.1. geom (table) Geometry specification. @@ -2452,16 +2426,14 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    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.
    @@ -2469,9 +2441,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    integer WMPlex.get_index(WMPlex mplex, WRegion reg) @@ -2488,9 +2458,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    table WMPlex.get_stdisp(WMPlex mplex) @@ -2506,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.
    @@ -2523,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) @@ -2540,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) @@ -2551,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.
    @@ -2560,9 +2523,7 @@ In addition parameters to the region to be created are passed in this

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

    -
    - - +
    Synopsis:
    WRegion WMPlex.mx_current(WMPlex mplex) @@ -2595,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) @@ -2606,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.
    @@ -2615,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.
    @@ -2633,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) @@ -2643,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.
    @@ -2652,9 +2607,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    void WMPlex.set_index(WMPlex mplex, WRegion reg, integer index) @@ -2664,10 +2617,16 @@ In addition parameters to the region to be created are passed in this
    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.
    @@ -2678,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) @@ -2698,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. @@ -2718,9 +2679,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    void WMPlex.switch_next(WMPlex mplex) @@ -2736,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) @@ -2753,9 +2710,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    void WMPlex.switch_prev(WMPlex mplex) @@ -2770,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) @@ -2795,9 +2748,7 @@ In addition parameters to the region to be created are passed in this

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

    -
    - - +
    Synopsis:
    table WMoveresMode.geom(WMoveresMode mode) @@ -2830,9 +2779,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    void WMoveresMode.move(WMoveresMode mode, integer horizmul, integer vertmul) @@ -2863,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) @@ -2883,9 +2828,7 @@ In addition parameters to the region to be created are passed in this

    -
    - - +
    Synopsis:
    table WMoveresMode.rqgeom(WMoveresMode mode, table g) @@ -2900,16 +2843,14 @@ In addition parameters to the region to be created are passed in this

    -

    -6.1.9 WRegion functions +

    +6.1.10 WRegion functions

    -
    - - +
    Synopsis:
    WMoveresMode WRegion.begin_kbresize(WRegion reg) @@ -2929,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.
    @@ -2947,9 +2886,7 @@ In addition parameters to the region to be created are passed in this

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

    -
    - - +
    Synopsis:
    table WRegion.get_configuration(WRegion reg, bool clientwins) @@ -2983,9 +2918,7 @@ In addition parameters to the region to be created are passed in this

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

    -
    - - +
    Synopsis:
    WRegion WRegion.groupleader_of(WRegion reg) @@ -3023,12 +2954,10 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    -
    bool WRegion.is_active(WRegion reg) +
    bool WRegion.is_active(WRegion reg, bool pseudoact_ok)
    Description:
    @@ -3040,9 +2969,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    void WRegion.rqclose(WRegion reg, bool relocate) @@ -3174,8 +3087,8 @@ Note that this function is asynchronous; the region will not the client supports the WM_DELETE protocol (see also 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 + 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.
    @@ -3184,9 +3097,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    WRegion WRegion.rqclose_propagate(WRegion reg, WRegion maybe_sub) @@ -3205,9 +3116,7 @@ Note that this function is asynchronous; the region will not

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

    -
    - - +
    Synopsis:
    bool WRegion.rqorder(WRegion reg, string ord) @@ -3235,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'.
    @@ -3243,9 +3150,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    WScreen WRegion.screen_of(WRegion reg) @@ -3260,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'.
    @@ -3278,9 +3181,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool WRegion.set_name(WRegion reg, string p) @@ -3288,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. @@ -3298,9 +3199,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool WRegion.set_name_exact(WRegion reg, string p) @@ -3309,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.
    @@ -3317,9 +3216,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool WRegion.set_tagged(WRegion reg, string how) @@ -3327,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.
    @@ -3335,9 +3233,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    table WRegion.size_hints(WRegion reg) @@ -3353,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) @@ -3376,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) @@ -3400,9 +3292,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool WScreen.set_managed_offset(WScreen scr, table offset) @@ -3419,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) @@ -3445,9 +3384,7 @@ Note that this function is asynchronous; the region will not

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

    -
    - - +
    Synopsis:
    double WWindow.xid(WWindow wwin) @@ -3480,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, ...) @@ -3502,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.
    @@ -3526,9 +3458,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    void gr.refresh() @@ -3543,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 @@ -3563,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) @@ -3586,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) @@ -3610,9 +3534,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

    -
    - - +
    Synopsis:
    void mod_tiling.set(table tab) @@ -3739,9 +3649,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool mod_tiling.untile(WTiling tiling) @@ -3763,9 +3671,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    WSplit WSplitSplit.br(WSplitSplit split) @@ -3903,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'.
    @@ -3921,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.
    @@ -3938,9 +3828,7 @@ Note that this function is asynchronous; the region will not

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

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

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

    -
    - - +
    Synopsis:
    WRegion WTiling.farthest(WTiling ws, string dirstr, bool any) @@ -4007,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.
    @@ -4016,9 +3898,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    bool WTiling.managed_i(WTiling ws, function iterfn) @@ -4027,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.
    @@ -4036,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) @@ -4046,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. @@ -4056,9 +3936,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    WSplitRegion WTiling.node_of(WTiling ws, WRegion reg) @@ -4074,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) @@ -4084,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).
    @@ -4094,9 +3971,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    WSplitSplit WTiling.set_floating(WTiling ws, WSplitSplit split, string how) @@ -4104,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.
    @@ -4113,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.
    @@ -4132,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) @@ -4142,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.
    @@ -4154,9 +4027,7 @@ Note that this function is asynchronous; the region will not

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

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

    -
    - - +
    Synopsis:
    void WTiling.unsplit_at(WTiling ws, WRegion reg) @@ -4212,9 +4079,7 @@ Note that this function is asynchronous; the region will not
    -
    - - +
    Synopsis:
    mod_query.defcmd(cmd, fn) @@ -4229,9 +4094,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    mod_query.message(mplex, str) @@ -4246,9 +4109,7 @@ Note that this function is asynchronous; the region will not

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

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

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

    -
    - - +
    Synopsis:
    bool mod_query.history_push(string str) @@ -4315,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) @@ -4336,9 +4189,7 @@ Note that this function is asynchronous; the region will not

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

    -
    - - +
    Synopsis:
    void mod_query.set(table tab) @@ -4381,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). +
    @@ -4389,19 +4242,18 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    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 @@ -4413,9 +4265,7 @@ Note that this function is asynchronous; the region will not

    -
    - - +
    Synopsis:
    mod_query.query(mplex, prompt, initvalue, handler, completor, @@ -4440,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.
    @@ -4459,9 +4307,7 @@ Note that this function is asynchronous; the region will not

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

    -
    - - +
    Synopsis:
    mod_query.query_exec(mplex) @@ -4499,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.
    @@ -4518,9 +4360,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

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

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    mod_query.warn(mplex, str) @@ -4782,9 +4596,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    void WEdln.complete(WEdln wedln, string cycle, string mode) @@ -4924,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.
    @@ -4936,9 +4735,7 @@ Note that this function is asynchronous; the region will not

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    void WInput.scrollup(WInput input) @@ -5456,9 +5197,7 @@ Note that this function is asynchronous; the selection will not
    -
    - - +
    Synopsis:
    mod_menu.grabmenu(mplex, sub, menu_or_name, param) @@ -5475,9 +5214,7 @@ Note that this function is asynchronous; the selection will not

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

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

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

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

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

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

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

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

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

    -
    - - +
    Synopsis:
    void WMenu.typeahead_clear(WMenu menu) @@ -5688,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) @@ -5711,9 +5428,7 @@ Note that this function is asynchronous; the selection will not

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

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

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

    -
    - - +
    Synopsis:
    void WDock.set(WDock dock, table conftab) @@ -5788,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. @@ -5819,9 +5531,7 @@ Any parameters not explicitly set in conftab will be left unchanged.
    -
    - - +
    Synopsis:
    bool mod_sp.set_shown(WFrame sp, string how) @@ -5829,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.
    @@ -5837,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) @@ -5847,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.
    @@ -5861,9 +5573,88 @@ Any parameters not explicitly set in conftab will be left unchanged.
    -
    - - +
    +
    +
    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() @@ -5875,6 +5666,22 @@ Any parameters not explicitly set in conftab will be left unchanged.
    +

    + +

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

    @@ -5884,9 +5691,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    table WStatusBar.get_template_table(WStatusBar sb) @@ -5901,12 +5706,10 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    -
    bool WStatusBar.is_systray_extl(WStatusBar sb) +
    bool WStatusBar.is_systray(WStatusBar sb)
    Description:
    @@ -5918,9 +5721,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    bool WStatusBar.set_systray(WStatusBar sb, string how) @@ -5928,7 +5729,8 @@ Any parameters not explicitly set in conftab will be left unchanged.
    Description:
    Enable or disable use of sb as systray. - The parameter how can be one of (set/unset/toggle). + The parameter how can be one of + `set', `unset', or `toggle'. Resulting state is returned.
    @@ -5937,9 +5739,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    void WStatusBar.set_template(WStatusBar sb, string tmpl) @@ -5954,9 +5754,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    void WStatusBar.set_template_table(WStatusBar sb, table t) @@ -5971,9 +5769,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    void WStatusBar.update(WStatusBar sb, table t) @@ -5994,9 +5790,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

    -
    - - +
    Synopsis:
    bool de.defstyle(string name, table tab) @@ -6011,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) @@ -6028,9 +5820,7 @@ Any parameters not explicitly set in conftab will be left unchanged.

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

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

    -
    +
    Hook name:
    @@ -6105,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 @@ -6142,7 +5930,7 @@ reg:attach(cwin)

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

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

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

    -
    +
    Hook name:
    @@ -6231,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 @@ -6250,7 +6038,7 @@ reg:attach(cwin)

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

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

    -
    +
    Hook name:
    @@ -6304,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.
    @@ -6312,7 +6100,7 @@ reg:attach(cwin)

    -
    +
    Hook name:
    @@ -6332,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:
    @@ -6368,7 +6176,7 @@ reg:attach(cwin) res_frame WFrame -A succesfull handler should +A successful handler should return the target frame here. @@ -6384,7 +6192,7 @@ reg:attach(cwin)

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

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

    -
    +
    Hook name:
    @@ -6476,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. @@ -6496,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