X-Git-Url: https://git.decadent.org.uk/gitweb/?p=ion3-doc.git;a=blobdiff_plain;f=ionconf%2Fnode4.html;fp=ionconf%2Fnode4.html;h=69145a539bb99cf7ae20c47092a4318744b230bc;hp=3980bc4e3ca85283da27a51afb3a2a4931da043b;hb=428266c577f55bd77cf036ed0d2af379613471e4;hpb=4ea582c4cff64f9aa2309f46cef0161143cb1faf diff --git a/ionconf/node4.html b/ionconf/node4.html index 3980bc4..69145a5 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 Subsections @@ -172,9 +172,9 @@ For a reference on exported functions, see section /usr/local/etc/ion3/ unless you, the OS package maintainer or whoever installed the package on the system has modified the variables -PREFIX or -ETCDIR in -system.mk before compiling Ion. +PREFIX or +ETCDIR in +system.mk before compiling Ion. In the first case you probably know where to find the files and in the other case the system administrator or the OS package maintainer should have provided documentation to point to the correct location. @@ -619,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="#foot878">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. @@ -633,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.

@@ -662,10 +662,10 @@ Ion ignores the Lock modifier and any ) -bound to NumLock or -ScrollLock +bound to NumLock or +ScrollLock by default because such3.2 locking keys may otherwise + HREF="#foot857">3.2 locking keys may otherwise cause confusion.

@@ -678,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 @@ -729,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 @@ -856,9 +856,6 @@ handlers (and elsewhere): Keyboard (or mouse) operated menus that open in the bottom-left corner of a screen or frame. -mod_menu.bigmenu -Same as previous, but uses another graphical style. - mod_menu.pmenu Mouse-operated drop-down menus. This function can only be called from a mouse press or drag handler. @@ -894,7 +891,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 @@ -912,7 +909,7 @@ usual method of identifying windows, and how to obtain this information.

Description:
-
+
Set this to true for Acrobat Reader. It has an annoying habit of trying to manage its dialogs instead of setting them as transients and letting the window manager do its job, causing @@ -930,7 +927,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Set this to open the window in a floating frame, when in a group. @@ -945,7 +942,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should the window be initially in full screen mode?
@@ -959,7 +956,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should configure requests on the window be ignored? Only has effect on floating windows. @@ -974,7 +971,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Ignore extended WM hints _NET_ACTIVE_WINDOW request.
@@ -988,7 +985,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should a newly created client window always be made active, even if the allocated frame isn't. @@ -1003,7 +1000,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
If the region specified by target winprop does not exist (or that winprop is not set), create a new workspace using the previously stored layout (see ioncore.deflayout) named by @@ -1022,7 +1019,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Discard this winprop after first use.
@@ -1036,7 +1033,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
The orientation of the window: one of `vertical' or `horizontal'. This is only useful when using the window as a status display. @@ -1052,7 +1049,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Put the window in the statusbar, in the named tray component, (The default tray component is called simply `systray', and others you give names to in your custom template, always @@ -1069,7 +1066,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should a newly mapped client window be switched to within its frame. @@ -1084,7 +1081,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
The name of an object (workspace, frame) that should manage windows of this type. See also new_group. @@ -1099,7 +1096,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
`normal': No change in behaviour. `current': The window should be thought of as a transient for the current active client window (if any) even if it is not marked as a @@ -1118,7 +1115,7 @@ usual method of identifying windows, and how to obtain this information.
Description:
-
+
Should frames be made transparent when this window is selected?
@@ -1133,15 +1130,15 @@ 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 @@ -1149,7 +1146,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 @@ -1165,12 +1162,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. @@ -1258,7 +1255,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 @@ -1267,7 +1264,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 @@ -1276,7 +1273,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="#foot1486">3.3

Finally, it should be mentioned that too many authors these days ``forget'' to set this vital identification to anything meaningful: @@ -1514,19 +1511,19 @@ for the additional mailboxes (`*' varying).



Footnotes

-
...keysymdef.h...keysymdef.h3.1
This file can usually be found in the directory /usr/X11R6/include/X11/.
-
... such... such3.2
Completely useless keys that should be gotten rid of in the author's opinion.
-
... window.... window.3.3
There's a patch to xprop to fix this, but nothing seems to be happening with respect to including it in @@ -1536,31 +1533,31 @@ XFree86.