X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;f=ionconf%2Fnode4.html;h=fba3b2c6237886926f8b2356f6fc770280d96d6a;hb=refs%2Fheads%2Ftuomov;hp=f041fdff8e43d782bf30cf5ae234d050df30af6f;hpb=3e627fc0998d082559ba00e28cbb264eb38b288d;p=ion3-doc.git diff --git a/ionconf/node4.html b/ionconf/node4.html index f041fdf..fba3b2c 100644 --- a/ionconf/node4.html +++ b/ionconf/node4.html @@ -28,31 +28,31 @@ original version by: Nikos Drakos, CBLU, University of Leeds
@@ -61,76 +61,76 @@ original version by: Nikos Drakos, CBLU, University of Leeds SubsectionsAll the configuration files are named cfg_*.lua with the ``*'' part varying. The configuration file for each module mod_modname is cfg_modname.lua, with modname varying by the module in -question. The following table summarises these and other configuration +question. Configuration files can also be compiled into .lc files, +and these are attempted by the configuration file search routines before +.lua files. + +
+The following table summarises these and other configuration files:
@@ -393,11 +400,11 @@ bind the same function to different key for different types of objects. Indeed, the workspace and frame tab switching functions are the same both classes being based on WMPlex, and in the stock configuration the switch to :th workspaces is bound to Mod1+n while the switch to :th tab is bound to the sequence Mod1+k n. @@ -612,8 +619,8 @@ defbindings("WFrame", { As seen above, the functions that create key binding specifications require a keyspec argument. This argument should be a string containing the name of a key as listed in the X header file keysymdef.h3.1 without the XK_ prefix. - + HREF="#foot886">3.1 without the XK_ prefix. + Most of the key names are quite intuitive while some are not. For example, the Enter key on the main part of the keyboard has the less common name Return while the one the numpad is called KP_Enter. @@ -626,21 +633,21 @@ modifiers:
Shift, Control, Mod1 to Mod5, AnyModifier and Lock. - - - - - + + + + +
X allows binding all of these modifiers to almost any key and while this list of modifiers does not explicitly list keys such as -Alt that are common on modern keyboards, such +Alt that are common on modern keyboards, such keys are bound to one of the ModN. On systems running XFree86 Alt is usually Mod1. On Suns Mod1 is the diamond key and Alt something else. One of the ``flying window'' keys on so called Windows-keyboards is probably mapped to Mod3 if you have -such a key. Use the program xmodmap +such a key. Use the program xmodmap to find out what exactly is bound where.
@@ -652,13 +659,13 @@ default.
Ion ignores the Lock modifier and any ModN () -bound to NumLock or -ScrollLock +bound to NumLock or +ScrollLock by default because such3.2 locking keys may otherwise + HREF="#foot865">3.2 locking keys may otherwise cause confusion.
@@ -671,7 +678,7 @@ cause confusion. Button specifications are similar to key definitions but now instead of specifying modifiers and a key, you specify modifiers and one of the button names Button1 to -Button5. Additionally the +Button5. Additionally the specification may end with an optional area name following an @-sign. Only frames currently support areas, and the supported values in this case are @@ -722,10 +729,10 @@ to it is available virtually everywhere.
- - - - + + + + In the stock configuration file setup, menus are defined in the file cfg_menus.lua as previously mentioned. The mod_menu module must be loaded for one to be able to define menus, and this is done with @@ -849,9 +856,6 @@ handlers (and elsewhere):
-The grabmenu function takes the extra key parameter, but -aside from that each of these functions takes three arguments, which when +Each of these functions takes three arguments, which when called from a binding handler, should be the parameters to the handler, and the name of the menu. For example, the following snippet of of code binds the both ways to open a context menu for a frame: @@ -887,7 +890,7 @@ defbindings("WFrame", {
-The so-called ``winprops'' can be used to change how +The so-called ``winprops'' can be used to change how specific windows are handled and to set up some kludges to deal with badly behaving applications. They are defined by calling the function defwinprop with a table containing the properties to set and the @@ -905,7 +908,7 @@ usual method of identifying windows, and how to obtain this information.
Additionally, the winprops -max_size, -min_size, -aspect, -resizeinc, +max_size, +min_size, +aspect, +resizeinc, and -ignore_max_size, -ignore_min_size, -ignore_aspect, -ignore_resizeinc, +ignore_max_size, +ignore_min_size, +ignore_aspect, +ignore_resizeinc, may be used to override application-supplied size hints. The four first ones are tables with the fields w and h, indicating the width and height size hints in pixels, and the latter ignore @@ -1142,7 +1145,7 @@ winprop is a boolean.
Finally, the boolean -userpos option may be used to +userpos option may be used to override the USPosition flag of the size hints. Normally, when this flag is set, Ion tries to respect the supplied window position more than when it is not set. Obviously, this makes sense @@ -1158,12 +1161,12 @@ only for floating windows.
The identification information supported are -class, -role, -instance, -name, -is_transient, and -is_dockapp. +class, +role, +instance, +name, +is_transient, and +is_dockapp. It is not necessary to specify all of these fields. The first three are strings, and must exactly match the corresponding information obtained from the window's properties. @@ -1251,7 +1254,7 @@ can be used to list the identification information required to set winprops for a window and all the transient windows managed within it.
- + Another way to get the identification information is to use xprop. Simply run To get class and instance, simply run xprop WM_CLASS and click on the particular window of interest. The class is the latter of @@ -1260,7 +1263,7 @@ windows have this property - use the command xprop WM_ROLE. This method, however, will not work on transients.
- + So-called ``transient windows'' are usually short-lived dialogs (although some programs abuse this property) that have a parent window that they are ``transient for''. On tiled workspaces Ion displays these windows @@ -1269,7 +1272,7 @@ Unfortunately xprop is stupid and can't cope with this situation, returning the parent window's properties when the transient is clicked on. For this reason you'll have to do a little extra work to get the properties for that window.3.3 + HREF="#foot1489">3.3
Finally, it should be mentioned that too many authors these days ``forget'' to set this vital identification to anything meaningful: @@ -1507,19 +1510,19 @@ for the additional mailboxes (`*' varying).