From b0cf3ec0261fe7ce00146ca92b659fef5a742ae4 Mon Sep 17 00:00:00 2001 From: Michael Stapelberg Date: Tue, 26 May 2009 17:37:56 +0200 Subject: [PATCH] Document binding on Mode_switch in userguide, be more verbose in config --- docs/userguide | 42 +++++++++++++++++++++++++++++------------- i3.config | 3 +++ src/config.c | 2 +- 3 files changed, 33 insertions(+), 14 deletions(-) diff --git a/docs/userguide b/docs/userguide index 36c2af4b..3f337a19 100644 --- a/docs/userguide +++ b/docs/userguide @@ -3,21 +3,23 @@ i3 User’s Guide Michael Stapelberg May 2009 -This document contains all information you need to configuring and using the i3 window -manager. If it does not, please contact me on IRC, Jabber or E-Mail and I’ll help you out. +This document contains all information you need to configuring and using the i3 +window manager. If it does not, please contact me on IRC, Jabber or E-Mail and +I’ll help you out. == Configuring i3 TODO: document the other options, implement variables before terminal:: - Specifies the terminal emulator program you prefer. It will be started by default when - you press Mod1+Enter, but you can overwrite this. Refer to it as +$terminal+ to keep things - modular. + Specifies the terminal emulator program you prefer. It will be started + by default when you press Mod1+Enter, but you can overwrite this. Refer + to it as +$terminal+ to keep things modular. font:: - Specifies the default font you want i3 to use. Use an X core font descriptor here, like - +-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1+. You can use +xfontsel(1)+ - to pick one. + Specifies the default font you want i3 to use. Use an X core font + descriptor here, like + +-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1+. You can + use +xfontsel(1)+ to pick one. === Keyboard bindings @@ -37,13 +39,27 @@ bind Mod1+41 f bind Mod1+Shift+27 restart -------------------------------- +Available Modifiers: + +Mod1-Mod5, Shift, Control:: +Standard modifiers, see +xmodmap(1)+ + +Mode_switch:: +Unlike other window managers, i3 can use Mode_switch as a modifier. This allows +you to remap capslock (for example) to Mode_switch and use it for both: typing +umlauts or special characters 'and' having some comfortably reachable key +bindings. For example, when typing, capslock+1 or capslock+2 for switching +workspaces is totally convenient. Try it :-). + === Automatically putting clients on specific workspaces -It is recommended that you match on window classes whereever possible because some applications -first create their window and then care about setting the correct title. Firefox with Vimperator -comes to mind, as the window starts up being named Firefox and only when Vimperator is loaded, -the title changes. As i3 will get the title as soon as the application maps the window (mapping -means actually displaying it on the screen), you’d need to have to match on Firefox in this case. +It is recommended that you match on window classes whereever possible because +some applications first create their window and then care about setting the +correct title. Firefox with Vimperator comes to mind, as the window starts up +being named Firefox and only when Vimperator is loaded, the title changes. As +i3 will get the title as soon as the application maps the window (mapping means +actually displaying it on the screen), you’d need to have to match on Firefox +in this case. *Syntax*: ---------------------------------------------------- diff --git a/i3.config b/i3.config index c1369c73..7bc3fe80 100644 --- a/i3.config +++ b/i3.config @@ -1,6 +1,9 @@ # This configuration uses Mod1 and Mod3. Make sure they are mapped properly using xev(1) # and xmodmap(1). Usually, Mod1 is Alt (Alt_L) and Mod3 is Windows (Super_L) +# Tell i3 about your preferred terminal. You can refer to this as $terminal +# later. It is recommended to set this option to allow i3 to open a terminal +# containing the introduction on first start. terminal /usr/bin/urxvt # ISO 10646 = Unicode diff --git a/src/config.c b/src/config.c index 562b2e92..ab9ea9aa 100644 --- a/src/config.c +++ b/src/config.c @@ -144,7 +144,7 @@ void load_configuration(const char *override_configpath) { class_title++; char *end = strchr(class_title, '"'); if (end == NULL) - die("Malformatted assignment, couldn't find finishing quote\n"); + die("Malformed assignment, couldn't find terminating quote\n"); *end = '\0'; } else { /* If it is not quoted, we terminate it at the first space */ -- 2.39.5