FAQ (4837B)
1 wmii 3.10 2 3 @@ If you're reading this file before it's been installed, 4 @@ substitute the following directories for their placeholders. 5 @@ @DOCDIR@ doc/ 6 @@ @EXAMPLES@ examples/ 7 @@ @LOCALCONF@ ~/.wmii or ~/.wmii-hg (if this is a snapshot) 8 @@ @ALTDOC@ alternative_wmiircs/ 9 @@ 10 Frequently Asked Questions 11 ========================== 12 13 1. I've just upgraded and something doesn't work. 14 ------------------------------------------------- 15 If you compiled wmii yourself, please try again from a clean source 16 tree. If wmii still fails, try deleting or renaming your old 17 configuration files. If this fails, see questions #2. 18 19 2. I've read all of the docs, but I still need help. 20 ---------------------------------------------------- 21 You can get support[1] in the #suckless irc channel on irc.oftc.net, or 22 you can subscribe to the mailing list by sending an email to 23 dev+subscribe@suckless.org. You can also browse or search the 24 mailing list archives[2] at Gmane. 25 26 3. I think I've found a bug. 27 ---------------------------- 28 You can report bugs at the issue tracker at the Google Code 29 project[3]. Please be sure to search for your problem before you 30 open a new issue. 31 32 4. How do I get a list of keyboard shortcuts? 33 --------------------------------------------- 34 The default keyboard shortcuts are listed in both the wmii(1) 35 manpage and in the user guide[4]. You can also get a list of all 36 current keyboard shortcuts at any time by selecting 'showkeys' from 37 the actions menu (M-a). 38 39 5. How do I customize wmii? How do I change my keyboard shortcuts? 40 ------------------------------------------------------------------ 41 You can customize wmii by editing its configuration script. If 42 you're using the stock wmiirc configuration script, you can add key 43 bindings and change your theme by editing @LOCALCONF@/wmiirc_local. 44 See @EXAMPLES@/wmiirc_local for more information. You should also be 45 sure to read wmii(1) and the user guide[4]. 46 47 6. I've heard I can do my configuration in any language? 48 -------------------------------------------------------- 49 While wmii is driven by a sh(1) script by default, it ships with 50 configuration scripts in several other languages, and more still are 51 available elsewhere on the web. See @ALTDOC@/README for more 52 information. 53 54 7. I've made some changes to my configuration. How do I reload it? 55 ------------------------------------------------------------------ 56 You can rerun your wmiirc script from the actions menu at any time. 57 If you're running the stock wmiirc, just select wmiirc. If you're 58 running the python wmiirc (and haven't moved it to 59 @LOCALCONF@/wmiirc), type python/wmiirc, and so on. 60 61 8. How do I restart wmii without killing X? 62 ------------------------------------------- 63 You can either run 'exec wmii' from the actions menu or write 64 'exec wmii' to the /ctl virtual file. 65 66 9. Why is there space around my terminal windows? 67 ------------------------------------------------- 68 Your terminal has asked to only be resized in certain increments, 69 and there's not enough space for another row. `wmii` is forced to 70 compromise and leave blank space around it. If you'd rather wmii to 71 ignore the terminal's request, write 'incmode ignore'[5] to the /ctl 72 virtual file. Note, though, that this will prevent `wmii`'s normal 73 behavior of trying to keep these increment gaps as small as 74 possible, and will therefore result in more wasted space than 75 otherwise. 76 77 10. On FreeBSD, using p9p[6], I get an error about not being able to open /dev/fd/7. 78 ------------------------------------------------------------------------------------ 79 You need to mount fdescfs on /dev/fd. See the BUGS section of rc(1) 80 for details. 81 82 11. How do I set a background image? 83 ------------------------------------ 84 This isn't the job of a window manager. You can set the background 85 with a third party tool, such as wmsetbg, Esetbg, feh, qiv, 86 xsetroot, etc. 87 88 12. How do I enable sequential shortcuts (like in ratpoison)? 89 or How do I use wmii with emacs? The shortcuts collide! 90 ------------------------------------------------------------- 91 92 Some applications make extensive use of the Alt key. The preferred 93 solution is to use the Windows, Apple, or Penguin key in its place. 94 It's assigned the identifier Mod4 on most systems. Set the 95 following in wmiirc_local: 96 97 MODKEY=Mod4 98 99 Alternatively, you can use key chains, so you're required to press a 100 certain key combination before wmii accepts its shortcuts: 101 102 MODKEY=Control-i, 103 104 13. How do I find out the names of keys to define keyboard shorcuts? 105 -------------------------------------------------------------------- 106 The easiest way is to run wikeyname(1) and type the key you want to 107 bind. 108 109 110 [1] http://suckless.org/community 111 [2] http://dir.gmane.org/gmane.comp.misc.suckless 112 [3] http://wmii.googlecode.com/ 113 [4] @DOCDIR@/wmii.pdf 114 [5] For more information, see wmii(1). 115 [6] http://plan9.us 116